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Preface 


This redbook describes how VSE/ESA users can participate in Transmission 
Controi Protocoi/Internet Protocoi (TCP/IP) networks using the OpenConnect 
Systems (OCS) gateway soiution for VSE/ESA. This product provides 
connectivity between the TCP/IP network environment and the IBM SNA 
environment, including bi-directionai fiie transfer services, terminai emuiation, 
and printing. 

We guide you through ail steps required to instaii, customize and start using the 
TCP/iP gateway soiution for VSE/ESA, covering the VSE/ESA host system 
applications and the RISC/6000 gateway software. 

This document is written for system engineers or programmers responsibie for 
impiementing VSE/ESA host integration into TCP/IP networks. It assumes a 
basic knowiedge of TCP/IP concepts and protocols and a working knowledge of 
VM/ESA, VSE/ESA, ACF/VTAM and AIX. 


How This Redbook Is Organized 

The redbook is organized as follows: 

1. Part 1, "Introduction" 

• Chapter 1, “Introduction to TCP/IP” 

This chapter contains a very brief introduction to TCP/IP. 

• Chapter 2, “VSE/ESA and TCP/IP” 

This chapter provides an overview of the TCP/IP solution for VSE 
discussed in this document, OCS TCP/IP for VSE. 

2. Part 2, "OCS TCP/IP for VSE Installation and Implementation" 

• Chapter 3, “OCS Software Functional Overview” 

This chapter contains a functional overview of the OCS TCP/IP for VSE 
software. 

• Chapter 4, “Sample Environment” 

This chapter describes the laboratory environment at the ITSO Center 
Boeblingen where OCS TCP/IP for VSE was installed and tested. 

• Chapter 5, “Defining the OCS II Gateway to the Flost” 

This chapter discusses the preparation steps necessary to connect the 
VSE host and the OCS II Gateway to each other. 

• Chapter 6, “OC/FTP Server Installation and Customization” 

This chapter provides detailed information on how to install and 
customize the OpenConnect/File Transfer Program Server software. 

• Chapter 7, “OC/FTP Client Installation and Customization” 

This chapter provides detailed information on how to install and 
customize the OpenConnect/File Transfer Program Client software. 

• Chapter 8, “OC/Line Printer Daemon Installation and Customization” 
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This chapter provides information on how to instaii and customize the 
Line Printer Daemon. 

Chapter 9, “OC/RSH Ciient instaiiation and Customizatien” 

This chapter provides detaiied information on how to instaii and 
customize the OpenConnect/Remote Sheii Ciient software. 

Chapter 10, “OC/TELNET FS instaiiation and Customization” 

This chapter provides detaiied informatien on how to instaii and 
customize the OCS ii Teinet Server 3270 software. 

Chapter 11, “OC/SAM instaiiation and Customization” 

This chapter provides detaiied informatien on how to instaii and 
customize the OpenConnect/Socket Access Method software. 

Chapter 12, “OCS ii Gateway instaiiation and Customization” 

This chapter provides detaiied informatien on how to instaii and 
customize the OCS ii Gateway software on the RISC/6000. 

Chapter 14, “OCS Print Server Installation and Customization” 

This chapter provides detailed informatien on how to install and 
customize the OCS Print Server. 

Chapter 13, “OCS II Gateway Operatien” 

This chapter shows how to start and stop the OCS II Gateway. 

Chapter 15, “OCS Print Server Operation” 

This chapter shows how to start and stop the OCS Print Server. 

Chapter 16, “OpenConnectien for Channel Installation and 
Customization” 

This chapter describes the OpenConnectien for Channel installatien and 
customization. 

Chapter 20, “OC/Line Printer Daemon Operation and Examples” 

This chapter includes information on the OC/Line Printer Daemen 
operatien and examples. 

Chapter 17, “OpenConnectien for Channel Operatien” 

This chapter discusses the OpenConnectien for Channel eperation. 

Chapter 18, “OC/FTP Server Operation and Examples” 

This chapter centains examples of how to use the OpenConnect/File 
Transfer Program Server software. 

Chapter 19, “OC/FTP Client Operation and Examples” 

This chapter contains examples of how to use the OpenConnect/File 
Transfer Pregram Client software. 

Chapter 21, “OC/RSFI Client Operatien and Examples” 

This chapter contains examples of how to use the OpenConnect/Remote 
Shell Client software. 

Chapter 22, “OC/TELNET FS Operation and Examples” 

This chapter provides operatien and test examples for 
OpenConnect/TELNET Client Full Screen software. 



• Chapter 23, “OCS II Telnet Server Operation and Examples” 

This chapter provides operation and test exampies for OCS II Telnet 
Server 3270 software. 

• Chapter 24, “OC/SAM Programming” 

This chapter provides general information about writing 
OpenConnect/Socket Access Method application programs for VSE and 
contains OpenConnect/Socket Access Method examples. 

• Chapter 25, “Implementation Summary” 

This chapter provides summary charts showing the relationships of the 
interrelated parameters in the subsystems affected. 

3. Part 3, "Summary" 

• Chapter 26, “OpenConnect Systems Products Functions and Limitations 
Summary” 

This chapter summarizes the functions of the OCS TCP/IP for VSE 
solution and lists its limitations from a user point of view. 

4. Part 4, "Job Streams and Definition Examples" 

This part provides jobstreams and definitions used during implementation of 
OCS TCP/IP for VSE. 
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working at the International Technical Support Organization Bbblingen Center. 
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Comments Welcome 


We want our redbooks to be as helpful as possible. Should you have any 
comments about this or other redbooks, please send us a note at the following 
address: 

redbook@vnet.lbm.com 

Your comments are important to us! 
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Part 1. Introduction 


This document describes the instaiiatien and customizatien aspects of 
OpenConnect Systems (OCS) TCP/iP for VSE, a product providing access to 
TCP/iP networks for VSE/ESA environments. The product uses a "gateway" 
approach connecting to the TCP/iP network on one side and to the SNA network 
on the other. OCS TCP/iP for VSE uses a RiSC/6000 as gateway precesser. 

This part provides: 

• a brief introductien to TCP/iP 

• a generai description of OCS TCP/iP for VSE 
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Chapter 1. Introduction to TCP/IP 


Transmission Control Protocol/Internet Protocol (named TCP/IP after its two 
main standards) is a suite of protocols that can be used to communicate across 
any set of Interconnected networks called 'Internets". The word "internet" must 
not be confused with the word "Internet" (capital I). The Internet Is a special 
Internet connecting several million computers In many different countries. 

Resulting from research funded by the Department of Defense (DoD), TCP/IP has 
gained increasing Importance since its first implementation around 1980. 

The TCP/IP development began in 1971 by the 'Defense Advanced Research 
Projects Agency' (DARPA) - 10 years earlier than the work on the Open Systems 
Interconnection (OSI) Reference Model started. 

TCP/IP Is a peer-to-peer or host-to-host architecture. All systems, regardless of 
size, appear the same to all other systems on the network. Systems using 
TCP/IP functions are logically paired in a client-server relationship. In general, 
TCP/IP requests are issued from the client, or local host, and forwarded through 
an internet to the server, or foreign host. The server performs the function and 
returns the result to the client. TCP/IP is considered today as the industry-wide 
standard for connecting heterogeneous systems. 

The TCP/IP protocol suite consists of four functional layers, plus the physical link 
between the hosts: 

1. The Application Layer. 

Provides for application-to-application cooperation on the same host, 
network or across a set of interconnected networks. It is built on the 
services of the transport layer. Examples are Telnet (protocol for remote 
terminal connection), FTP (File Transfer Protocol), RSH (Remote Shell) and 
SMTP (Simple Mail Transfer Protocol) for electronic mail, NFS (Network File 
System), as well as for business specific client/server processing. 

2. The Transport Layer. 

Provides for reliable end-to-end data transfer. It is built on the services of 
the internetwork layer. Protocol examples are Transmission Control Protocol 
(connection-oriented) (TCP) and User Datagram Protocol (connectionless) 
(UDP). Both segment the data to be sent into packets, attach a header 
containing control information, pass the packets to the internetwork layer, 
and reassemble the data at the receiving end. In addition, (only) TCP 
ensures data integrity and ensures that each packet is received and that all 
packets are reassembled in proper order. If a packet is not received, TCP 
retransmits the packet. UDP offers no guarantee of data delivery, but has a 
minimum of protocol overhead. 

3. The Internet Layer. 

This layer is built on the services of the network interface layer to 
communicate with other TCP/IP hosts within the same network, and with 
hosts in other networks in an internet. The internet layer selects the next 
node to forward data to the final destination. It does not include provisions 
for reliable data transmission, flow control, or error recovery, since these 
services are provided by the transport layer. The most important protocol in 
this layer is IP. 
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4. The Network Interface Layer. 

Interfaces to the actual network hardware. TCP/IP supports many network 
interfaces, for example Token-Ring, ETHERNET, X.25, and Serial Line. The 
TCP/IP software will vary according to the type of media. 

The typical OSI model consists of seven layers. A comparison of the layers in 
OSI and in TCP/IP is shown in Figure 1. 


OSI 

TCP/IP 

Application 

Application 

Presentation 


Session 

Transport 

Transport 

Internet 

Network 

Network Interface 

Data Link 


Physical 

Physical 


Figure 1. Comparison of the OSI and the TCP/IP Model 

There are several books that describe TCP/IP in detail, for example: 

• TCP/IP Tutorial and Technical Overview, GG24-3376 

• Inside TCP/IP, SR28-5701 
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Chapter 2. VSE/ESA and TCP/IP 


The options for VSE/ESA to participate in TCP/iP networks are: 

• OCS TCP/IP for VSE 

Availabie from OCS (OpenConnect Systems), inc. as a part of the IBM 
Cooperative Software Program. This is the gateway soiution. 

• TCP/IP for VSE 

Avaiiabie from Connectivity Systems Inc., providing a native solution. For a 
description of this impiementation piease refer to TCP/IP Native Solution for 
VSE/ESA with Connectivity Systems Software - Implementation Guide 
(avaiiabie IQ 1997). 

This document describes and expiains the OCS TCP/iP for VSE gateway soiution. 


2.1 OCS TCP/IP for VSE 

OCS TCP/IP for VSE lets VSE/ESA participate in an internet network by providing 
client/server support for Telnet, FTP and RSH. TCP/IP Telnet and FTP clients as 
well as servers have now the ability to communicate with VSE/ESA. This is 
achieved via OCS software running on a RISC/6000, called the 'OCS II Gateway', 
which provides basic connectivity to VSE/ESA, that is, Telnet 3270 terminal 
access. In addition, there are six optional features available which execute on 
the VSE/ESA host: 

1. the OpenConnect/TELNET Client Full Screen (OC/TELNET FS), a VTAM 
application which provides ASCII terminal emulation for 3270 terminals. 

2. the OpenConnect/File Transfer Program Client (OC/FTP Client), a VTAM 
application which allows VSE users to initiate file transfer operations to and 
from remote TCP/IP nodes (in both batch or online mode). 

3. the OpenConnect/File Transfer Program Server (OC/FTP Server), running in a 
VSE dynamic batch partition and allowing remote TCP/IP nodes to move files 
to or get them from the VSE host. 

4. the OpenConnect/Remote Shell Client (OC/RSH Client), a VTAM application 
which allows VSE users to execute commands on a remote TCP/IP node (in 
both batch or online mode). 

5. the OpenConnect/Socket Access Method (OC/SAM), a development toolkit 
that provides the socket application interface on the VSE/ESA system to 
enable development of client/server applications distributed between VSE 
and TCP/IP systems. 

6. the OC/Line Printer Daemon (OC/LPD), a line printer server that allows 
clients on a TCP/IP network to use the VSE/ESA line printer as a remote 
printer. 

An optional feature executing on the OCS II Gateway is: 

• The OCS Print Server for AIX (OCS Print Server), installed in the RISC/6000 
emulates multiple 3287 CICS Report Controller terminal printers. 

A conceptual view of the OCS TCP/IP for VSE solution is shown in Figure 2 on 
page 6. 
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Figure 2. OCS TCP/IP for VSE Overview 


2.1.1 OC/Telnet 

OC/Telnet Server Manager is a gateway server that includes TN3270 and TN5250 
datastream servers, and 3278 and 5250 emulation servers. Host sessions with 
SNA hosts are monitored and controlled through the server manager. The 
datastream servers allow you to establish sessions with SNA host applications 
(through the gateway) on your TCP/IP terminal, PC, or UNIX host. The emulation 
servers allow you to use a TELNET client on your TCP/IP host, freeing up 
processing on the TCP/IP host, since the emulation prooessing occurs in the 
gateway. 


2.1.2 OC/FTP Client 

With OC/FTP Client installed on the VSE system, you can log on to an FTP server 
on a TCP/IP host that is connected with an OpenConnect Server, and transfer 
files between the two hosts (VSE and TCP/IP). 

OC/FTP Client provides access to the following VSE file types: 
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• VSAM ESDS 


• VSAM KSDS 

• VSAM SAM 

• VSE Library Members (ESA mode only) 

• VSE non-VSAM sequential data sets (SD files) 

OC/FTP Client may be used in on-line mode via the standard CICS command 
interface, or in off-line mode using JCL execution statements. 


2.1.3 OC/FTP Server 

With OC/FTP Server installed on the VSE system, you can log on to the VSE 
system from an TCP/IP FTP client on a TCP/IP network that is connected with an 
OpenConnect Server, and transfer files between the two hosts (VSE and TCP/IP). 

OC/FTP Server provides access to the following VSE file types: 

• VSAM ESDS 

• VSAM KSDS 

• VSAM SAM 

• VSE Library Members (ESA mode only) 

• VSE POWER queues (ESA mode only) 

• VSE non-VSAM sequential data sets (SD files) 

In the VSE/ESA environment, through the OC/FTP Server, FTP clients can submit 
jobs to VSE/POWER for execution on the VSE/ESA system and send files to the 
VSE/POWER queues for printing or punching. The FTP client can also retrieve 
data from the VSE/POWER queues. In addition, the FTP clients can send 
commands to VSE/POWER to display the contents of a queue, and release jobs 
for execution. 


2.1.4 OC/RSH Client 

OC/RSFI Client is a software program that allows System/370 users to access 
hosts on a TCP/IP network for execution of commands. 

The OC/RSFI Client program delivers commands to a remote TCP/IP host for 
execution by the remote command server program running on the TCP/IP host. 
The remote command server program validates the user's authorization for 
remote execution, executes the command, and returns the results of the 
command to the RSFI Client for presentation to the user. The command cannot 
perform interactively, the user has no ability to deliver any data to the command 
other than specified on the command line itself. The command must read its 
input from the standard UNIX input (stdin), and write any messages for the user 
to the standard UNIX output (stdout) 
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2.1.5 OC/SAM 


The OC/SAM (Socket Access Method) software product allows an IBM 
mainframe computer to communicate with a local area network using an 
OpenConnect Server. The OC/SAM program on the IBM mainframe 
communicates with a partner program on the LAN, using either the User 
Datagram Protocol (UDP) or Transmission Control Protocol (TCP). 

The SAM offers functions that take the complexity out of programming in the 
VTAM, CICS, and LAN environments. To start the process, the mainframe 
application obtains the internet address and port number of the partner program 
on the LAN. The data is then sent and received. The transmission control 
headers, VTAM protocol, and CICS requests are handled by the OC/SAM 
software product. The only programming required on the mainframe is related 
to the protocol established by the partner program. 


2.1.6 OC/Line Printer Daemon (LPD) 

The OC/LPD allows terminal users on a TCP/IP network to use the VSE/ESA line 
printer as a remote printer for their system. The OC/LPD product provides 
TCP/IP network users a method of printing ASCII text files on mainframe 
attached printers. Print files submitted to a standard LPR/LPD defined remote 
print queue In the TCP/IP network are passed through the gateway to the 
VSE/ESA host, where the resultant text Is printed using host-based printer 
resources. 


2.1.7 OCS II Gateway 

The OCS II Gateway Is a software-only version of OpenConnect Systems' wide 
range family of connectivity products that provide gateway, router, and protocol 
conversion functions. 

OCS 11 Gateway software provides System Network Architecture (SNA) 
connectivity for UNIX workstations or allows a UNIX workstation to function as a 
gateway between TCP/IP networks and SNA networks. OCS II Gateway provides 
the capability for data transfer between the SNA host system and intelligent 
devices within the TCP/IP network. 


2.1.8 OCS Print Server for AIX 

The OCS Print Server Is an AIX process to emulate multiple 3287 CICS terminal 
printers simultaneously. The print output Is automatically converted from 
EBCDIC to ASCII and routed to any local or remote printer defined on the AIX 
system. 


2.2 OpenConnection for Channei (OCC) 

OpenConnect System's OpenConnection for Channel (OCC) provides a 
mainframe channel attachment for the OpenConnect Systems software product 
OCS II Gateway. 
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OCC is a combination of software and hardware in its own enciosure, providing 
connectivity between a Smaii Computer System Interface (SCSI) on a UNIX host 
system and an IBM mainframe computer via a System/370 I/O Interface Channel 

The OCC is a channel attached hardware device that resides in the data path 
between an IBM channel and a SCSI interface on a UNIX workstation. OCC 
provides the physical and electrical connection between the UNIX workstation 
and the IBM bus and tag channel cables. 


2.3 Hardware and Software Requirements for OCS TCP/IP 

The following will briefly specify the required hardware and software in order to 
install and run OCS TCP/IP. 


2.3.1 Hardware Requirements 

The following hardware is required for OCS TCP/IP for VSE: 

1. OCS Gateway (RISC/6000) 

• OCS TCP/IP for VSE supports the RISC/6000 Models 320 or higher 

• Depending on the type of connection to TCP/IP and the VSE host, the 
appropriate hardware is required as shown in Table 1 


Connection 

Hardware Requirement 

Required For 

TCP/IP 

IBM Ethernet High-Performance 
LAN Adapter (entN) 

IBM Token-Ring 

High-Performance 

Adapter (tokN) 

Downstream TCP/IP workstation 
connectivity 

SNA SDLC 

IBM 4-Port Multiprotocol 
Communications Controller 
(mpqaN) 

IBM 4-Port Multiprotocol 

Interface Cable 

SNA host communications 
using SDLC 

Token-Ring 

IBM Token-Ring High- 
Performance Adapter (tokN) 

SNA host communications over 
Token-Ring 


Table 1. OCS TCP/IP for VSE Network Connection Options 


2. VSE Host 

• The optional features running on the host can be installed on any 
processor supporting VSE/ESA 

• A tape drive (for example, 3480) is required to load the appropriate 
distribution tape 

• One of the following connections is required to attach the host to the 
OCS gateway: 

- IBM Token-Ring 

- SNA SDLC 
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2.3.2 Software Requirements 

The following software Is required for OCS TCP/IP for VSE: 

1. OCS Gateway (RISC/6000) 

• AIX Version 3.1 or higher 

• depending on the type of connection to TCP/IP and the VSE host, the 
appropriate software Is required as shown in Table 2 


Product Name 

Description/BOS Section 

Required For 

bosnet.tcpip.obj 

TCP/IP Applications 

BOS Network Support 
Facilities 

OCS Gateway and TCP/IP 
LAN communications 

bosext2.dlctoken.obj 

Token-Ring Data Link 
Control 

BOS Extensions 2 

Interface Cable 

SNA host 

communications 
over Token-Ring 

bosext2.dlcsdlc.obj 

SDLC Data Link Control 

BOS Extensions 2 

SNA host 

communications 
using SDLC 


Table 2. OCS TCP/IP for VSE RISC/6000 Software Requirements 


2. VSE Host 

• VSE/ESA Version 1.3.2, or later 

• ACF/VTAM Version 3.4.0, or later 

• CICS/VSE Version 2.2, or later 

A typical OCC environment with OCS II serving as a gateway between a TCP/IP 
network and a channel attached IBM mainframe Is shown In Figure 3 on 
page 11. 
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Figure 3. OCC Environment 


2.3.3 OCC Hardware 

The OpenConnection for Channel (OCC) is a microcomputer system with 
electronics and logic components for directly connecting SCSI and System/370 
I/O channel. The OCC product is shipped with external power supply, channel 
cabling, and SCSI cabling. 

The OCC enclosure consists of the following components: 

• Main Circuit Board 

• SCSI Bus/Tag Transition Board 
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• Front Panel Assembly 

• Enclosure Base with Rear Panel 

• Enclosure Cover 


2.3.3.1 Main Circuit Board 

All logic components of the OCC reside on the main circuit board which Is 
mounted horizontally In the enclosure. The major components are: 

• CPU/Microcontroller 

• Memory 

• SCSI Interface 

• Channel Interface 

• Rear Panel Components 


2.3.3.2 SCSi Bus/Tag Transition Board 

The SCSI bus/tag transition board mounts vertically on the main circuit board at 
the rear of the OCC enclosure, and contains the following connectors: 

• SCSI Interface 

• Channel Interface 

• Main Board Connection 

The SCSI-2 connectors on the OCC enclosure are bl-directlonal. Either of these 
connectors can be used for connection of the SCSI In cable, the SCSI Out cable, 
or for the SCSI terminator as required. 

Note: If the OCC Is the only SCSI device connected to the SCSI host, or the last 
SCSI device In a chain, the SCSI terminator plug must be Installed In the 
unused SCSI connector on the OCC rear panel. 
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Part 2. OCS TCP/IP for VSE Installation and Implementation 


This part covers the implementation of a TCP/IP network for VSE/ESA using the 
software offered by OpenConnect Systems (OCS). It provides: 

• A functional overview of the OCS products described in this book 

• A description of the hardware, software and network used in our 
implementation 

• The definition of the OCS II Gateway to VM/VSE and native VSE host 
environments 

• The definitions of the SCSI to Channel environment (OCC) 

• The installation and customization of OpenConnect/File Transfer Program 
Server (OC/FTP Server) 

• The installatien and customizatien of OpenConnect/Line Printer Daemon 
(OC/LPD) 

• The installation and customization of OpenConnect/File Transfer Program 
Client (OC/FTP Client) 

• The installation and customization of OpenConnect/Remote Shell Client 
(OC/RSH Client) 

• The installatien and customization of OpenConnect/TELNET Client Full 
Screen (OC/TELNET FS) 

• The installation and customization of OpenConnect/Socket Access Method 
(OC/SAM) 

• The installation and customization of OpenConnect Server II Gateway on the 
RISC/6000 system (OCS II Gateway) 

• The installation and customization of OCS Print Server for AIX on the 
RISC/6000 system (OCS Print Server) 

• An implementation summary 

• The operation procedures and test samples of the OCS software 

• A list of issues and considerations reflecting our experiences 
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Chapter 3. OCS Software Functional Overview 


OCS TCP/IP for VSE is marketed by IBM through the Cooperative Software 
Program (CSP). Under this program, IBM is not responsible for, nor does IBM 
represent or warrant, the performance of the products. Technical support and 
assistance are provided by OCS. 

OCS TCP/IP for VSE consists of the following optional products: 

• OpenConnect Server II Gateway (OCS II) software Installed in the RISC/6000. 
Different program numbers are used, depending on the number of Logical 
Units (LUs) supported: 

- 5758-PC3 for 16 LUs 

- 5758-PC4 for 32 LUs 

- 5758-PC5 for 64 LUs 

- 5758-PC6 for 128 LUs 

- 5758-PC7 for 256 LUs 

The TELNET Server 3270 feature of the OCS II allows TCP/IP workstations to 
connect to VSE/ESA via the OCS II Gateway, and emulates as an IBM 3278 
terminal. This Is an optional feature and must be ordered If the terminal 
emulation function for ASCII terminals Is required. 

• OCS Print Server installed on the RISC/6000 

• OC/FTP Server (5758-PCO) Installed in VSE/ESA 

• OC/FTP Client (5758-PCI) installed in VSE/ESA 

• OC/LPD (5758-PC4) installed in VSE/ESA 

• OC/RSH Client (5758-PC8) installed in VSE/ESA 

• OC/TELNET FS (5758-PC2) installed in VSE/ESA 

• OC/SAM (5758-PC9) installed in VSE/ESA 

- Note - 

The program numbers listed above are for the U.S. and Canada only. The 
program numbers for OCS products may be different in other countries. 

Please consult the program announcement letter in your country for country 
specific information. 


These software products allow VSE/ESA to communicate with hosts and 
workstations attached to the TCP/IP network, performing file transfer, terminal 
emulation and remote command execution functions. 

The OC/SAM allows VSE/ESA users to write network applications communicating 
with other applications on TCP/IP hosts. 
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3.1 OCS II Gateway Functional Overview 

OCS II Gateway software resides in the RiSC/6000 system. It provides gateway 
functions between SNA and TCP/IP. The OCS II Gateway uses SNA protocols 
when communicating with the VSE/ESA SNA node; and standard TCP/IP 
protocols when communicating with the TCP/IP nodes. With the protocol 
translation and gateway function provided by OCS II Gateway, communication 
between VSE/ESA and TCP/IP nodes is made possible. TN3270 Server is 
supplied which allows interactive terminal sessions using TN3270 and TN3174G 
clients. 

For users having a TELNET client or ASCII terminals, the optional feature TELNET 
Server 3270 of OCS II Gateway allows connection to VSE/ESA, and emulates the 
TCP/IP terminal as an IBM 3278 terminal. 


Figure 4 illustrates a simplified view of the OCS II Gateway functions: 
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Figure 4. OCS II Gateway Functions 


From the SNA side of the gateway, OCS II Gateway: 

• Provides LU to LU sessions with VTAM applications and terminals 

• Uses SNA Path Information Unit (PIU) as the transmission unit between OCS 
II Gateway and VTAM 
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• Uses standard SNA commands and responses between OCS II Gateway and 
VTAM 

• Uses EBCDIC data 

From the TCP/IP side of the gateway, OCS II Gateway: 

• Communicates with TCP/IP nodes using IP addresses and host names 

• Provides iP routing to the TCP/IP nodes 

• Uses standard TCP/IP commands and responses between OCS II Gateway 
and the TCP/IP nodes 

• Uses ASCII data 

The gateway function of OCS II Gateway provides session management and 
protocol translation between these two different communication protocols. It 
provides: 

• Managing and mapping of LUs to/from IP addresses 

• Conversion and translation of PIUs to/from IP datagrams 

• Interpretation and translation of commands and responses between the SNA 
and TCP/IP protocols 

• EBCDIC to/from ASCII data translation 

• TN3270 Server allowing interactive terminal sessions using TN3270 and 
TN3179G 

TELNET Server 3270: This optional feature resides in the OCS II Gateway. It 
allows the TCP/IP TELNET clients to initiate a session with the VSE/ESA SNA 
host, and log on to VTAM applications as an IBM 3278 terminal. The terminal 
keyboard mapping can be customized for terminal definitions that are not 
provided by the software. Please refer to Chapter 12, “OCS II Gateway 
Installatien and Customization” on page 153 fer the customization details. 

The OC/TELNET Server is a gateway server that includes TN3270 and TN5250 
datastream servers, and 3278 and 5250 emulation servers. Host sessions with 
SNA hosts are monitored and controlled through the server manager. The 
datastream servers allow you to establish sessions with SNA host applications 
on your TCP/IP terminal, PC, or UNIX host. The emulatien servers allow you to 
use a TELNET client on your TCP/IP host. 

Figure 5 on page 18 illustrates the connection of a TCP/IP TELNET client te 
VSE/ESA using TELNET Server. 
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Figure 5. OCS II Gateway TELNET Server Functions 


3.2 OC/FTP Server Functional Overview 

OC/FTP Server runs in a VSE/ESA dynamic partition as a VTAM appiication. it 
ailows the FTP ciients in the TCP/IP network to initiate an FTP connection with 
VSE/ESA. 

Once connected, the TCP/IP FTP clients may perform file transfer functions 
between the: 

• TCP/IP FTP client file system 

• VSE/ESA library 

• SAM/ESDS files in VSAM managed space 

• VSAM Data Sets (Entry Sequenced Data Sets (ESDS), Key Sequenced Data 
Sets (KSDS)) 

• POWER sped files 

The TCP/IP FTP client may alse issue commands to POWER (for example 
PALTER, PDISPLAY). User cemmands for OC/FTP Server are discussed in 
Chapter 18, “OC/FTP Server Operation and Examples” on page 219. 

Some of the potential usages of this product for the TCP/IP FTP clients are: 

• Putting data into VSE/ESA VSAM data sets 

• Obtaining data files from VSE/ESA VSAM data sets 

• Placing procedures and pregrams into VSE/ESA libraries 

• Retrieving procedures and programs from VSE/ESA libraries 

• Submitting jobs to execute in VSE/ESA threugh the POWER RDR queue 

• Getting VSE/ESA jebs from the POWER RDR queue 

• Retrieving listings and punch output from the POWER LST and PUN queues 

• Manipulating the POWER RDR, PUN and LST queues with POWER 
commands 
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Figure 6. OC/FTP Server Functions 

Figure 6 provides a simpiified iliustration of how OC/FTP Server functions: 

• After VTAM, OC/FTP Server, and OCS li Gateway are initiaiized, the OC/FTP 
Server program estabiishes an LU-LU session with an LU in OCS II Gateway. 
The OC/FTP Server program acts as the Primary LU (PLU) and the OCS II 
Gateway LU acts as the Secondary LU (SLU). The system is ready to accept 
requests from the TCP/IP FTP clients 

• The TCP/IP FTP client initiates an FTP session request to OC/FTP Server via 
OCS II Gateway 

• OCS II Gateway translates and routes the OPEN command from the TCP/IP 
FTP client to OC/FTP Server via the LU-LU session 

• After the FTP session request is accepted by OC/FTP Server, the TCP/IP FTP 
client may issue FTP commands such as PUT, GET and SITE. The FTP 
commands available to the TCP/IP FTP client depend on the software 
installed in the FTP client's node 
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• The request is passed via the LU-LU session from OCS II Gateway to OC/FTP 
Server 

• Depending on the nature of the request, OC/FTP Server may request the 
services of: 

- VSE Librarian, if the request is to access the VSE/ESA library 

- VSE/VSAM, if the request is to access a VSAM ESDS or KSDS file 

- VSE/POWER, If the request Is a POWER command or a request to access 
the POWER RDR, LST or PUN file 

• The requested file (files for MGET and MPUT commands) Is routed to the 
target node via OCS II Gateway 

• The FTP client may terminate the FTP session by a CLOSE command 


3.3 OC/FTP Client Functional Overview 

OC/FTP Client runs in a VSE/ESA dynamic partition as a VTAM application. It 
enables the VSE/ESA users to Initiate an FTP connection with an FTP server 
node connected to the TCP/IP network. Once connected, the VSE/ESA FTP 
clients may perform file transfer functions between the: 

• TCP/IP FTP server file system, 

• VSE/ESA library and 

• VSAM ESDS or KSDS 

• SAM/ESDS files in VSAM managed space 

User commands for OC/FTP Client are listed in Chapter 19, “OC/FTP Client 
Operation and Examples” on page 239. 

Some of the potential usages of this product for the VSE/ESA FTP clients are: 

• Putting data into VSE/ESA VSAM ESDS/KSDS or libraries from the TCP/IP 
FTP server file system 

• Putting data Into the TCP/IP FTP server file system from VSE/ESA libraries or 
VSAM ESDS/KSDS 

• Obtaining files from the TCP/IP FTP server file system (that Is databases, 
bulletins, fora) 

• Retrieving procedures and programs from the TCP/IP FTP server file system 
to VSE/ESA libraries 

• Placing procedures and programs from VSE/ESA libraries into the TCP/IP 
FTP server file system 
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Figure 7. OC/FTP Client Functions 


Figure 7 provides a simplified illustration of how OC/FTP Client functions: 

• After VTAM, OC/FTP Client and OCS II Gateway are initialized, the system is 
ready to accept requests from the VSE/ESA users 

• The VSE/ESA users may initiate an FTP session from a CICS transaction 
(FTP) or batch job. OC/FTP Client supports concurrent VSE/ESA online and 
batch FTP clients 

• When the CICS FTP transaction is invoked from the CICS terminal, the online 
interface of OC/FTP Client is initialized in the OC/FTP Client partition. The 
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maximum number of the online FTP clients is determined at this stage, 
based on the specifications of the OC/FTP Client customization. Please refer 
to 7.2, “OC/FTP Client Customization” on page 82 for details 

• When OC/FTP Client is invoked from a batch job, OC/FTP Client and its 
off-line interface are started in the batch dynamic partition 

• When an FTP session request is issued from the VSE/ESA FTP client, an 
LU-LU session is created between the OC/FTP Client program and the OCS II 
Gateway LU. The OC/FTP Client program acts as the PLU, while the OCS II 
Gateway LU acts as the SLU 

• OC/FTP Client interprets the session request and passes it to OCS II 
Gateway via the LU-LU session 

• OCS II Gateway translates the request into TCP/IP format and routes it to the 
target TCP/IP FTP server 

• Once the session request is accepted by the TCP/IP FTP server, the VSE/ESA 
FTP client is requested to log in to the FTP server 

• The VSE/ESA FTP client may issue FTP commands such as PUT and GET, to 
initiate file transfer to/from the TCP/IP FTP server 

• The request is translated and routed to the target TCP/IP FTP server via OCS 
II Gateway 

• Depending on the nature of the request, OC/FTP Client may request the 
services of: 

- VSE Librarian, if the request is to access the VSE/ESA library 

- VSE/VSAM, if the request is to access a VSAM ESDS or KSDS file 

- The TCP/IP FTP server file system, if the request is to access the TCP/IP 
FTP server files 

• The requested file (files for MGET and MPUT commands) is routed to the 
target system via OCS II Gateway 

• The VSE/ESA FTP client may terminate the FTP session by a CLOSE 
command. This also terminates the LU-LU session between OC/FTP Client 
and the OCS II Gateway LUs 


3.4 OC/Line Printer Daemon Functional Overview 

OC/Line Printer Daemon runs in a VSE/ESA dynamic partition as a VTAM 
application. It allows the LPR clients in the TCP/IP network to initiate and send 
print data to VSE/ESA. 
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Figure 8. OC/Line Printer Daemon Functions 


Figure 8 provides a simpiified iiiustration of how OC/LPD functions: 

• After VTAM, OC/LPD, and OCS li Gateway are initialized, the OC/LPD 
program estabiishes an LU-LU session with an LU in OCS II Gateway. The 
OC/LPD program acts as the Primary LU (PLU) and the OCS II Gateway LU 
acts as the Secondary LU (SLU). The system is ready to accept requests 
from the TCP/IP LPR clients 

• The TCP/IP LPR client initiates an LPR print session request to OC/LPD via 
OCS il Gateway 

• OCS il Gateway translates and routes the OPEN command from the TCP/IP 
LPR client to OC/Line Printer Daemon via the LU-LU session 

• After the LPR session request is accepted by OC/Line Printer Daemon, the 
TCP/IP LPR client may send the print request 

• The print data is spooled to the POWER LST queue or stored in a VSAM SAM 
ESDS file 
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• If the E-mail feature is enabled, OC/LPD establishes an LU-LU session with 
an LU in OCS II Gateway and connects to an SMTP server to queue mail to 
the E-mail address specified as originator of the print request 


3.5 OC/RSH Client Functional Overview 

OC/RSH Client runs in a VSE/ESA dynamic partition as a VTAM application. It 
enables the VSE/ESA users to execute commands on remote TCP/IP hosts. 

Once connected, the VSE/ESA RSH clients may execute commands on the 
remote TCP/IP host. The OC/RSH Client program is designed to invoke 
programs on remote TCP/IP bests that obtain their input from the cemmand line 
and write the output to standard output devices. 

User commands for OC/RSH Client are listed in Chapter 21, “OC/RSH Client 
Operation and Examples” en page 281. 

Some ef the petential usages for VSE/ESA RSH clients are: 

• Listing directories from remote TCP/IP systems without going through the 
FTP login process 

• Manipulating files in the TCP/IP server file system 
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Figure 9. OC/RSH Client Functions 


Figure 9 provides a simpiified iliustration of how the OC/RSH Ciient works: 

• After VTAM, OC/RSH Ciient and OCS il Gateway are initiaiized, the system is 
ready to accept remote sheii ciient requests from VSE/ESA users 

• The VSE/ESA users may initiate an RSH command execution from a CiCS 
transaction (RSH) or a batch job. OC/RSH Client supports concurrent 
VSE/ESA oniine and batch RSH ciients 

• When the CICS RSH transaction is invoked from the CiCS terminal, the online 
interface of OC/RSH Ciient is initiaiized in the OC/RSH Ciient partition. The 
OC/RSH Client is, in fact, an extension of the OC/FTP Client; this is why 
Figure 9 shows 'OCSFTPC' as the application for RSH transactions and batch 
requests 

• When OC/RSH Ciient is invoked from a batch job, OC/RSH Client and its 
off-line interface are started in the batch dynamic partition 

• When an RSH request is issued from the VSE/ESA RSH ciient, an LU-LU 
session is created between the OC/RSH Client program and the OCS II 
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Gateway LU. The OC/RSH Client program acts as the PLU, while the OCS II 
Gateway LU acts as the SLU 

• OC/RSH Client passes the command request to OCS II Gateway via the 
LU-LU session 

• OCS II Gateway translates the command into TCP/IP format and routes it to 
the target TCP/IP RSH server 

• The VSE/ESA RSH client holds the RSH session after the command execution 
for future command executions 


3.6 OC/TELNET FS Functional Overview 

OC/TELNET FS runs in a VSE/ESA dynamic partition as a VTAM application. It 
enables the VSE/ESA users from a VTAM terminal, to initiate a TELNET 
connection to a TELNET server connected to the TCP/IP network. OC/TELNET FS 
provides terminal functions to emulate an IBM 3278 type terminal as a VT100, 
VT200, page or line mode terminal. Default keyboard mapping is provided by 
OC/TELNET FS, and can be customized according to the users' requirements. 
Customization of the keyboard mapping is discussed in 10.2, “OC/TELNET FS 
Customization” on page 134. 

Once the TELNET session is established, the VTAM terminal is emulated as an 
ASCII workstation of the target TCP/IP TELNET server. 
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Figure 10. OC/TELNET FS Functions 


Figure 10 provides a simplified illustration of how OC/TELNET FS functions: 

• After VTAM, OC/TELNET FS and OCS II Gateway are initialized, the system is 
ready to accept requests from the VSE/ESA TELNET clients 

• When a VSE/ESA TELNET client logs on to OC/TELNET FS from a VTAM 
terminal, an LU-LU session is established between OC/TELNET FS and the 
VTAM terminal LU. OC/TELNET FS acts as the PLU, and the VTAM terminal 
LU acts as the SLU 

• The VSE/ESA TELNET client may then request a TELNET session to the 
TCP/IP TELNET server by the OPEN option. OC/TELNET FS creates an LU-LU 
session with the LU in the OCS II Gateway. OC/TELNET FS acts as the PLU, 
and the OCS II Gateway LU acts as the SLU. The VTAM terminal LU is then 
'connected' to the OCS II Gateway LU 

• The gateway function in OCS II Gateway translates the session request and 
routes it to the target TCP/IP TELNET server 
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• After the TCP/IP TELNET server accepts the sessien request, the VSE/ESA 
TELNET client may use the VTAM terminal as a local terminal attached to the 
TCP/IP TELNET server 

• The VSE/ESA TELNET client may terminate the TELNET session by the 
CLOSE option. This also terminates the LU-LL) session between OC/TELNET 
FS and OCS II Gateway 

• The VSE/ESA client may log off from OC/TELNET FS by the OUIT option. This 
also terminates the LU-LU session between OC/TELNET FS and the VTAM 
terminal LU 


3.7 OC/SAM Functional Overview 

OC/SAM Is a program development toolkit that provides a socket application 
Interface for VSE/ESA to enable the development of client/server applications 
between VSE/ESA and TCP/IP systems. OCS/SAM allows a VSE application to 
communicate with an application residing on a TCP/IP system connected through 
an OpenConnect server. For a VSE/ESA system, OC/SAM Implements the 
functions of the Berkley socket application programming interface available for 
TCP/IP systems. OC/SAM provides an API for communication programs using 
either of two transport protocols, TCP (Transmission Control Protocol) or UDP 
(User Datagram Protocol). 

OC/SAM provides two programming environments: 

1. The OC/SAM function library 

The base library to be used by programming languages that conform to IBM 
standard calling conventions. 

2. The Berkley Software Distribution (BSD) 4.3 library 

The BSD function library, available to C and ASM/370 programming 
environments. These functions provide the basis for the socket 
implementations used by UNIX and IBM/PC platforms. 
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Figure 11. OC/SAM Functions 


The figure above prevides a simplified view of how OC/SAM functions: 

• After VTAM and OCS II Gateway are initialized, the system is ready to accept 
requests 

• A VSE SAM application program can be either the server fer (one or more) 
client programs on TCP/IP nodes, or a client program asking for services 
from a TCP/IP server program 

• The VSE SAM applicatien program first initializes the interface te the 
OpenConnect Server 

• Then it sends messages to the applicatien program on the TCP/IP nede and 
receives responses from it 

The VSE/ESA OC/SAM application programs communicate with remote TCP/IP 
programs using either the TCP or UDP API. The interface between the 
mainframe application and the OpenConnect server is determined by the 
ACF/VTAM APPL and LU definitions. OC/SAM can be used from any available 
programming language that provides access to S/370 assembler calls. 
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3.8 OCS Software Functional Overview 


The figure below shows a simplified overview of the different TCP/IP programs 
and how they interact with the OCS II Gateway in the RISC/6000 and the different 
VSE/ESA programs in the IBM 9221. The figure does NOT show all details, it is 
just included to give an overall feeling of how the different parts interact with 
each other. 
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Figure 12. OCS Software Functional Overview 
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Chapter 4. Sample Environment 


Our test environment consists of a working TCP/IP network, and the components 
that we added to aiiow VSE/ESA to participate in the network. The resuiting 
network is iiiustrated in Figure 13 on page 34, and it consists of the foiiowing 
hardware and software. 


4.1 Hardware 

• An IBM 9221 Model 421 as the host with: 

- 128MB main memory 

- Parallel channel connecting to the IBM 3174 

- Token-Ring adapter connecting to the IBM Token-Ring LAN 

• An IBM 3174 Model 11L with: 

- 6MB of real memory 

- Configuration support C release 3 

- Token-Ring adapter 

• A RISC/6000 Model 320 as the OCS II Gateway with: 

- 32MB main memory 

- Token-Ring adapter connecting to the IBM Token-Ring Backbone LAN 

• An IBM 8209 IBM Token-Ring LAN Bridge as a bridge between two IBM 
Token-Ring LANs 

• A RISC/6000 Model 520 as a router between the IBM Token-Ring Backbone 
LAN and Ethernet LAN 

- 32MB main memory 

- Token-Ring adapter connecting to the IBM Token-Ring Backbone LAN 

- Ethernet LAN adapter connecting to the Ethernet LAN 

• An IBM PS/2 Model 70 as a router between two IBM Token-Ring LANs. This 
PS/2 also acts as a domain name server as well as an OS/2 Client 

- 10MB main memory 

- Token-Ring adapter connecting to the IBM Backbone Token-Ring LAN 

- Token-Ring adapter connecting to another IBM Token-Ring LAN 

• An IBM PS/2 Model 70 attached to the IBM Token-Ring Backbone LAN as a 
PC DOS Client 

- 2MB main memory 

- Token-Ring adapter connecting to the IBM Backbone Token-Ring LAN 

• An IBM PC 350-PI 00 attached to the IBM Token-Ring Backbone LAN as an 
OS/2 Client (not part of Figure 13 on page 34) 

- 32MB main memory 

- Token-Ring adapter connecting to the IBM Backbone Token-Ring LAN 
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• A RISC/6000 Model 560 as an AIX UNIX Client from another IBM Token-Ring 
LAN 

- 32MB main memory 

- Token-Ring adapter connecting to the IBM Token-Ring LAN 

• A SUN Sparc workstation attached to the Ethernet LAN as a SunOS UNIX 
Client 


4.2 Software 

• IBM 9221 Host 

- VM/ESA R2.1 with CCS and ACF/VTAM V3.4.1 in the IBM 9221 

- VSE/ESA V2.1.2 guest under VM in the IBM 9221 with 

- ACF/VTAM V4.2.0 

- OC/FTP Server V2.2.4.1, OC/FTP Client V2.2.4.1, OC/TELNET FS V4.11, 
OC/LPD VI.1.0, OC/SAM V2.1, OC/RSH V2.1.5 

• RS/6000-320 OCS II Gateway 

- AIX 3.2.5 preloaded with the following also installed: 

- bosext2.dlctoken.obj 3.2.0, bosnet.tcpip.ob] 3.2.0 

- OpenConnect Server II 16 LU with Telnet Server V3.7.5 

- OpenConnect/Print Server for AIX VI.2 

• RS/6000-520 AIX Router 

- AIX 3.2.5 preloaded with the following also installed: 

- bosext2.dlcether.obj 3.2.0, bosext2.dlctoken.obj 3.2.0 

- bosnet.tcpip.obj 3.2.0 

- Other Software Applications 

• PS/2-70 PC Router, Name Server & OS/2 Client 

- OS/2 V2.10 CSD Level XRU2010 

- Lan Adapter and Protocol Support (LAPS) V2.13 CSD Level WR06000 

- Comm Manager/2 VI.0 

- TCP/IP for OS/2 2.0 & 2.1 Base CSD Level UN64092 

- Domain Name Server Kit V2.0 without CSD 

• PS/2-70 PC DOS Client 

- PC DOS 6.1 

- Microsoft Windows 3.1 

- TCP/IP for DOS 2.1.1 without CSD, Token-Ring Driver, NDIS Interface 

• PC 350-PI00 OS/2 Client (not part of Figure 13 on page 34) 

- OS/2 Warp Verion 3 with DOS and Windows Application Support 

- Multi Protocol Transport Services (MPTS) 

- TCP/IP for OS/2 Version 3 

• RS/6000-560 AIX UNIX Client 
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- AIX 3.2.5 preloaded with the following also installed: 

- bosext2.dlctoken.obj 3.2.0, bosnet.tcpip.obj 

- Other Software Applications 

• SUN Sparc Workstation SunOS UNIX Client 

- SunOS 4.3 with TCP/IP & Ethernet driver installed 

- Other Software Applications 


4.3 Network Configuration 

Figure 13 on page 34 illustrates the network used in our implementation. 

Our TCP/IP Network mainly consists of three networks, two routers and seven 
hosts: 

• A Token-Ring Backbone Network bridging with a small Token-Ring Network 
through 8209 Token-Ring Bridge device. This TCP/IP Network uses a Class C 
address 192.61.100 with a Subnet Mask 255.255.255.0 and has the following 
TCP/IP nodes attached to it: 

1. VM/ESA and VSE/ESA in the IBM 9221 with: 

- VM-owned IBM 3174 connecting to the IBM Token-Ring LAN 

- VSE-owned IBM 9221 Token-Ring adapter conneoting to the IBM 
Token-Ring LAN 

- OCS software installed in VSE/ESA 

2. A RISC/6000-320 running AIX with OCS II Gateway Software installed 

3. An OS/2 Router also acting as an OS/2 Client 

4. A PC/DOS Windows Client 

5. A RISC/6000-520 Router 

• A small Token-Ring Network connecting to the Token-Ring Backbone 
Network through an OS/2 Router. This TCP/IP Network uses a Class A 
address 9.164.182 with a Subnet Mask 255.255.255.0 and has the following 
TCP/IP node attaohed: 

- RISC/6000 AIX UNIX Client 

• An Ethernet Network connecting to the Token-Ring Backbone Network 
through a RISC/6000 Router. This TCP/IP Network uses a Class C address 
192.61.200 with a Subnet Mask 255.255.255.0 and has the following TCP/IP 
node attached: 

- A SUN Sparc SunOS UNIX Client 
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NAME: AIX320 

AIX 3.2.5 

Token-Ring 


ROUTER 

Backbone 

PS/2 70 

NAME: RS6TECTR,RS6 


OS/2 2.1.0 

55 


ROUTER/NAME SERVER 

SUN Sparc 

83 

NAME: TCPCLl 

SunOS 

199 PS/2 70 

142 

NAME: SUN2 91 

Windows 3.1 

9.164.182 


NAME: TCPCL3 

Token-Ring 

192.61.200 



Ethernet 


132 RS/6000-560 

Doniain Name : ITSC.IBM.CQM 

AIX 3.2.5 

Domain Name Server : 

TCPCLl.ITSC.IHM.COM 

NAME: AIX560 


Figure 13. OCS TCP/IP Network Diagram 
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4.3.1 OCS II Gateway Attachment Configurations 

The OCS II Gateway may be connected to the host using an SDLC line, an IBM 
Token-Ring LAN, or the OpenConnection for Channel box. There are many 
different options available, such as attachment through the IBM 37x5 
communication oontroller, IBM 3172, IBM 3174, and IBM 9221 integrated 
communication adapters (Multi-Protocol Communication Subsystem and IBM 
Token-Ring LAN Subsystem). 

The following three attachment configurations are selected, to illustrate the 
implementations of OCS TCP/IP for VSE in the VM/VSE and native VSE 
environments. 

• Attachment of OCS II Gateway via the IBM 3174 

This attaohment represents a VM/VSE environment where OCS II Gateway is 
owned by and defined in VM/ESA. The OCS II Gateway LUs are defined as 
cross domain resources in VSE/ESA. 

Virtual Channel to Channel Adapter (VCTCA) is used to connect VSE VTAM 
and VM VTAM. 

Details of this configuration are covered in 5.1, “VM/VSE with OCS II 
Gateway Attached via the IBM 3174” on page 41. 

• Attaohment of OCS II Gateway via the IBM 9221 Token-Ring adapter 

This attachment represents a native VSE/ESA environment where OCS II 
Gateway is owned by and defined in VSE/ESA. 

Details of this configuration are covered in 5.2, “VSE/ESA with OCS II 
Gateway Attached via the Token-Ring Adapter” on page 50. 

• Attachment of OCS II Gateway via the OpenConnection for Channel 

This attachment represents a native VSE/ESA environment where OCS II 
Gateway is owned by and defined in VSE/ESA. Details can be found in 5.3, 
“VSE/ESA with OSCII Gateway Attached via the OCC” on page 56. 


4.3.2 IP Address and Name Assignments 

As illustrated in Figure 13 on page 34, the configuration consists of three 
networks oonneoting by two routers RISC/6000-520 and OS/2 2.1. There also are 
two types of Client PC (DOS & OS/2) and UNIX (AIX & SunOS). Table 3 on 
page 36 summarizes the IP address and name assignments for our network: 
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Network Node 

IP Address 

IP Node Name 

RISC/6000-320 OCS II Gatewayi 

192.61.100.81 

AIX320 

RlSC/6000-520 LAN router 

192.61.100.55 

RS6TECTR 

192.61.200.55 

RS6 

OS/2 2.1 LAN routers 

192.61.100.83 

TCPCL1 

9.164.182.142 


PS/2 Model 70 WindowsS 

192.61.100.199 

TCPCL3 

RISC/6000-560 

9.164.182.132 

AIX560 

SUN Sparc Workstation 

192.61.200.91 

SUN2 


Note: 


1. The OCS II Gateway IP address and name apply to the OCS applications In 
VSE/ESA and OCS II Gateway. VSE/ESA is not a TCP/IP node and does not have 
an IP address. The OCS applications must communicate with other TCP/IP nodes 
through the OCS II Gateway 

2. The OS/2 2.1 also functions as a client for OCS applications in VSE/ESA 

3. This PC/DOS Client also has TCP/IP Windows applications installed 
Table 3. IP Address and Name Assignment for the OCS Implementation 


4.4 Router Functions 

In a TCP/IP environment, a host connects to a network, and a network connects 
to other networks through routers. 

In our configuration, we have empioyed two routers, one on the RS/6000-520 and 
another one on a PS/2 Modei 70 to connect one Ethernet and one Token-Ring 
network to the Backbone Token-Ring Network, (see Figure 13 on page 34). This 
has been set up to iliustrate a situation which can be found at many customer 
sites. If your VSE host wants to connect to remote TCP/IP hosts or nodes on 
another network (of the same or different IP class) via one or more routers, the 
routing tables in each TCP/IP node need to be set up accordingly. 

For more informatien on the best netwerk member customization, please refer to 
7.2.4, “FTP Client Custemization” on page 92. 

There are three types of route that can be established: 

• Implicit route - is defined when the adapter is configured 

• Explicit route - also referred te as 'static route' which has to be ceded 
explicitly 

• Dynamic route - employs a daemon process te periodically update the 
routing table (reuted or gated daemon) 

The IP routing algorithm will only consider the IP network address part of the 
destination address. By looking through the routing table, it performs 
sequentially: 

1. Direct renting - direct network attach 

2. Indirect renting - specific route to a remote host via a gateway 
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3. Default routing - default route to a remote host via a gateway; this is used 
when the destination IP network address is not found in the direct or indirect 
routing entries 

When default routing is applied and the destination network still cannot be 
reached, the message "No route to host" is issued. Figure 14 shows the logical 
view of our network and in Table 4 the corresponding routing table entries for 
each of our TCP/IP nodes are listed. 


PC/DOS 

HOST VSE 

OCS 11 

192.61.100 


55 

83 


RS-520 

PC/OS2 


ROUTER 

ROUTER 


55 

142 

192.61.200 


9.164.182 

SOSf 


RS-560 


Figure 14. OCS TCP/IP Network Logical View 


TCP/IP Node 

Route Type 

Destination 

Router 

PC/DOS Windows Client 

Net 

192.61.200 

192.61.100.55 

Default 


192.61.100.83 

RISC/6000-320 OCS II 

Net 

192.61.200 

192.61.100.55 

Default 


192.61.100.83 

RISC/6000-520 Router 

Neti 

9.164.182 

192.61.100.83 

Default 


192.61.100.83 

OS/2 2.1 Router 

Neti 

192.61.200 

192.61.100.55 

Default 


192.61.100.55 

SUN UNIX Client 

Default 


192.61.200.55 

RISC/6000-560 UNIX Client 

Default 


9.164.182.142 


Note: 

1. If this route type is omitted, Default routing will be used instead of Indirect 
routing. 


Table 4. Routing Table for TCP/IP Nodes 
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4.5 PC/DOS Windows Client in our Test Environment 


Many of the standard TCP/IP applications (Teinet, FTP and so on) are supported 
on UNIX and PC platforms. In addition to the standard TCP/iP appiications FTP, 
Teinet and RSFI the CCS II Gateway supports also the Socket Access Method for 
VSE/ESA to provide for TCP/IP network applications. 

We have also looked into the capabilities of the PC/DOS Windows Client to 
participate in our test environment. Figure 15 shows the IBM TCP/IP for DOS 
V.2.11 Windows applications that are contained in the base package. 



Figure 15. IBM TCP/IP Windows Applications 


There are three applications which we used quite often in our environment. 

They all have a graphical interface and provide very useful functions: 

1. TELNET Client - wtelnet.exe 

In this application, we can define TCP/IP hosts to which we want to log on. A 
click on the host's icon gets us a telnet session to that host. Figure 16 shows 
the GUI of this Telnet application. 
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Figure 16. Telnet Windows Application on PC/DOS 


2. FTP Client - wftp.exe 

This application reduces the FTP operation to a 'point and click' interface. 
Your local and remote file systems will be represented in the upper and 
lower box. To copy or move files, just select files and click on the up or down 
arrows. 
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Problem 


We were unable to get this application to work with the OC/FTP Server. 
The system type this application supports must be OS/2, MVS, VM, 
AS/400, UNIX, SUN, FTP Inc., NetManage, DOS or Negotiate, that is, 
VSE/ESA is not supported. The error message says that the remote host 
doesn't return the system type when trying with 'Negotiate'. 


Figure 17 shows the GUI of the FTP application in session with an AIX host. 
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Figure 17. FTP Windows Applications on PC/DOS 


3. SMTP mail client and server 

SMTP stands for Simple Mail Transfer Protocol. On the PC/DOS Windows, 
you can implement your mail as SMTP ONLY or POP. POP stands for Post 
Office Protocol, in this case the PC has to retrieve the mail from a POP 
Server in certain intervals of time. We have set up our PC/DOS to use SMTP 
ONLY for the mail function. Figure 18 on page 40 shows the GUI of the mail 
application: 
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Figure 18. Mail Windows Application on PC/DOS 
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Chapter 5. Defining the OCS ii Gateway to the Host 


This chapter covers the definitiens in VM, VSE and VTAM te impiement the two 
seiected attachments for the OCS Ii Gateway. 

Independent ef the OCS II Gateway attachment configuration, OCS II Gateway is 
defined to the owning VTAM as Physical Unit (PU) type 2. PU name IPFP2209 
with LU names ranging from IPFT2S9A to IPFT2S9P are used. The LU names 
assigned to the OCS applications are: 

• IPFT2S9A to OC/FTP Server 

• IPFT2S9B - IPFT2S9H to OC/FTP Client 

• IPFT2S9I to OC/LPD 

• IPFT2S9J - IPFT2S9L to the OC/TELNET FS out-bound terminal emulation 
sessions 

• IPFT2S9M to the terminal printer session 

• IPFT2S9N - IPFT2S90 to the OC/TELNET FS in-bound terminal emulation 
sessions 

• IPFT2S9P to OC/SAM sample programs 

The LUs are defined in VM VTAM, VSE VTAM, OCS II Gateway and the OCS 
application customization. Details of the LU parameters are covered in the OCS 
II Gateway and OCS application customization chapters. 

To automatically start up the path table and major nodes during VTAM 
initialization, their names are included in the VTAM configuratien list. 

- Definition of the PS/2 workstations - 

No SNA definition is required for TCP/IP nodes that communicate with 
VSE/ESA via the OCS II Gateway. In our network implementation, the PS/2 
workstatiens participate in the netwerk only through TCP/IP. SNA definition 
is therefore not required. 


5.1 VM/VSE with OCS II Gateway Attached via the IBM 3174 

In this cenfiguratien, VM VTAM owns the IBM 3174 and OCS II Gateway. Both of 
these controllers are defined in the VTAM Local SNA major node. VM VTAM 
communicates with VSE VTAM through VCTCA, using line address 800 on both 
sides. 

VSE/ESA runs as a guest (user ID V132A80K) under VM/ESA. The LUs of OCS II 
Gateway are defined in the cross domain resources major node. 

To prepare for this connection configuration, the following environments are 
custemized: 

• VM/ESA 

• VM VTAM 
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IBM 9221 


• VSE/ESA 

• VSE VTAM 

The definitions in both VM/ESA and VSE/ESA are cioseiy reiated, and certain 
definition parameter vaiues must match. Figure 19 on page 43 provides a 
summary of the attachment configuration and VTAM definitions. Pointers in the 
diagram iliustrate the reiationships of the definitions and where parameter 
vaiues must match. This diagram shouid be referred to whiie studying the 
sampie definitions provided in this document. 
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V132A80K 

TCPCDRS CDRSC Major Node 

VSE/ESA 

IPFT2S9A CDRSC CDRiy^IPFV2 


IPFT2S9P CDRSC CDRM^IPFVC 

SSCPNAME=IPFV2B 

TCPCDRM 

CDRM Major Node 

SUBAREA=22 

IPFV2B 

CDRM SUBAREA=22 


IPFV2 

CDRM SUBAREA=2 

NETID=DEIHy[[PF 

TCPCTCA 

CA Major Node 


TCPCG800 GROUP LNCTLCTCA 


TCPCL800 

LINE ADDRESS=800 


VSE VTAM Path Table 

ACF/VTAM 

IPFHWT2 

PATH DESTSA=2,ER0= 

VSE 800 



.CTCA. 



VM 800 

VM VTAM 

Path Table 

ACF/VTAM 

IPFH2TW 

PATH DESTSA=22,ER0= 

SSCPNAME=IPFV2 

VM VTAM 

CA Major Node 

SUBAREA=02 

VLG800 

GROUP LNCTtCTCA 

NETID=DEIHyiIPF 

VCL800 

LINE ADDRESS=800 

VM/ESA 

VM VTAM 

CDRM Major Node 


IPFFV2 

CDRM SUBAREA=02 

200 

IPFV2B 

CDRM SUBAREA=22 

3174 

VM VTAM 

Local SNA Major Node 

IBM T-R LAN 

IPFCP200 PU CUADDR=200 


IPFT2S02 

LU LOCADDR=02 

209 

IPFT2S33 

LU LOCADDR=33 

OCS II Gateway 




IPFP2209 PU CUADDR=209 

PU IPFP2209 



LU 1 IPFT2S9A 

IPFT2S9A LU LOCADDR=01 

LU 16 IPFT2S9P 

IPFT2S9P LU LOCADDR=16 

Figure 19. Configuration and Definition Summary for 3174 Connection 
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5.1.1 Customization in VM/ESA 

The following tasks are performed in VM/ESA: 

• Define the IBM 3174 and RISC/6000 centrollers to VM/ESA 

• Tailor the VTAM user directery to support VCTCA, IBM 3174 and RISC/6000 

• Tailor the VSE/ESA user directery (V132A80K) to support VCTCA 

• Tailor the PROFILE EXEC of VTAM or VSE/ESA guest to couple the VCTCA 
connections 


5.1.1.1 Device Definitions 

VM/ESA R2.1 uses dynamic cenfiguration and automatic device sensing. Static 
device definiticn is net required. The follcwing statements are included in the 
VM SYSTEM CONFIG file, to activate and aute-sense device addresses 0000-FFFF 
during system initialization. 


Devices , 


Online_at_IPL 

0000-FFFF, 

Sensed 

0000-FFFF 


Figure 20. Device Address Definitions in SYSTEM CONFIG File 


5.1.1.2 VTAM User Directory 

The following commands are included in the VTAM user directory: 

• SPECIAL 800 CTCA V132A80K. Defines the VCTCA 800 attachment to the 
VSE/ESA guest V132A80K 

• DEDICATE 200 2000. Dedicates the IBM 3174 controller to VTAM 

• DEDICATE 209 2009. Dedicates the RISC/6000 controller te VTAM 

5.1.1.3 VSE/ESA User Directory 

The following command is included in the VSE/ESA user directory (V132A80K), to 
define the VCTCA 800 connection to VM VTAM: 

SPECIAL 800 CTCA VTAM 

5.1.1.4 PROFILE EXEC 

To automatically connect VCTCA between VTAM and the VSE/ESA guest, one of 
the following commands is used: 

• CP COUPLE 800 V132A80K 800 in the PROFILE EXEC of VM VTAM or 

• CP COUPLE 800 VTAM 800 in the PROFILE EXEC of the VSE/ESA guest 
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5.1.2 Customization in VM VTAM 

The following VTAM definitions in VM VTAM are required to implement our 
network configuration: 

• Path table for the cross domain communication with the VSE/ESA guest 

• CA major node to define VCTCA 

• CDRM major node to define the cross domain resource managers 

• LOCAL SNA major node to define the IBM 3174 and RISC/6000 PUs and LUs 


5.1.2.1 VTAM Path Table 

A path is required to enable the cross domain communication from VM VTAM to 
VSE VTAM using VCTCA. The following path is defined to the VTAM path table: 


IPFH2TW PATH DESTSA=22,ER0= (22,1) ,ER1= (22,1) ,ER2= (22,1) ,ER3= (22,1), C 
ER4=(22,1) ,ER5=(22,1) ,ER6=(22,1) ,ER7=(22,1), C 

VR0=0, VR1=1, VR2=2, VR3=3, VR4=4, VR5=5, VR6=6, VR7=7 


Figure 21. VM VTAM Path Table 

The destination and adjacent subareas must match the host subarea of the 
VSE/ESA guest. The transmission group, explicit and virtual routes must 
correspond to the definitions in the VSE/ESA guest's path table. 


5.1.2.2 VTAM CTCA Major Node 

A CA major node is created to define VCTCA to VTAM. Listed in Figure 22 is the 
definition we used: 



VBUILD TYPE=CA 




VLG800 

GROUP LNCTLCTCA, 

■k-k 

CTCA TO V132A80K 

**C 



DELAY=.020, 

k-k 

NORMAIj=DEFAULT, MAX=30 

**C 



MAXBFRU=(2), 

kk 

NORMALf=DEFAULT, MAX=30 

**C 



MIH=YES, 

kk 

NORMAL=DEFAULT, MAX=30 

**C 



REPLYTO=25.5, 

kk 

DEFAULT 

**C 



ISTATUS=ACTIVE 

kk 

DEFAULT 


VCL800 

LINE 

ADDRESS=800, 

kk 

DEFINE C-T-C LINK 74DDR. 

**C 



ISTATUS=ACTIVE 

kk 

DEFAULT 


VPU800 

PU 

PUTYPE=4, 

kk 

DEFINE C-T-C LINK STA. 

**c 



ISTATUS=ACTIVE 

kk 

DEFAULT 



Figure 22. VM VTAM CA Major Node for VCTCA 


The line address (800) must match the address defined in the VM VTAM and VSE 
guest user directories. PU type 4 is defined for the VCTCA connection. 
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5.1.2.3 VTAM CDRM Major Node 

CDRM major node is used to identify the cross domain resource manager 
functions of the iocai and remote VTAMs. 

Figure 23 iists the definitions we used. The first statement defines the iocai 
VTAM CDRM and the second statement defines the remote VTAM CDRM. The 
CDRM name is the same as the SSCPNAME in the owning VTAM start options 
list. 

A VTAM start options list example is provided in A.2, “VSE VTAM Start Options 
List” on page 341. 



VBUILD 

TYPE=CDRM 


IPEV2 

CDRM 

SUBAREA=02, CDRDYN=YES 

** SA=02 BOEVMIS2 

IPEV2B 

CDRM 

SUBAREA=22, CDRSCOPT 

** SA=22 V132A80K 


Figure 23. VM VTAM CDRM Major Node 


5.1.2.4 VTAM Local SNA Major Node 

The IBM 3174 and OCS II Gateway PUs and LUs are defined in the Local SNA 
major node. Illustrated in Figure 24 on page 47 are the definitions for the 
controllers. 

CUADDR must match the addresses defined in the VTAM user directery fer these 
twe centrollers. The key parameters of the OCS II Gateway PU are discussed in 
5.2.3, “Customization in VSE VTAM” on page 53. 
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VBUILD TYPE=LOCAL 

* DEFINE THE GATEWAY 3174 CONTROLLER PU 

IPFCP200 PU 

CUADDR=200, 

C 


DELAY=0.2, 

C 


ISTATUS=ACTIVE, 

c 


MAXBFRU=29, 

c 


PUTYPE=2, 

c 


XID=YES, FOR APPN SUPPORT 

c 


DYNLU=YES, 

c 


USSTAB=ISTSNA, MODETAB=ISTINCIM, DLOGMOD=D4A32782 


* DEFINE COAX-ATTACHED (NON-GATEWAY) TERMINAL LUS 

IPFT2S02 LU 

LOGADDR=02, LOGAPPL=IPFA2VSC 


IPFT2S03 LU 

LOGADDR=03, LOGAPPL=IPFA2VSC 


IPFT2S32 LU 

LOGADDR=32, LOGAPPL=IPFA2VSC 


IPFT2S33 LU 

■k 

LOGADDR=33, LOGAPPL=IPFA2VSC 


* DEFINE THE DOWNSTREAM RS/6000 PU ATTACHED TO THE GATEWAY 

IPFP2209 PU 

CUADDR=209, 

c 


DELAY=0.2, 

c 


ISTATUS=ACTIVE, 

c 


MAXBFRU=7, 

c 


PUTYPE=2, 

c 


XID=NO, 

c 


USSTAB=ISTSNA,MODETAB=OCSBIND,DLOGMOD=OCSLUO, 

c 


PACING=0,VPACING=0, 

c 


SECNET=YES 


IPFT2S9A LU 

LOGADDR=01, LOGAPPIKXiSFTPS 


IPFT2S9B LU 

LOGADDR=02 


IPFT2S9C LU 

LOGADDR=03 


IPFT2S9D LU 

LOGADDR=04 


IPFT2S9E LU 

LOGADDR=05 


IPFT2S9F LU 

LOGADDR=06 


IPFT2S9G LU 

LOGADDR=07 


IPFT2S9H LU 

LOGADDR=08 


IPFT2S9I LU 

LOGADDR=09 


IPFT2S9J LU 

LOGADDR=10,DLOGMOD=OCSLUO,PACING=1,VPACING=2 


IPFT2S9K LU 

LOGADDR=ll,DLOGMOD=OCSLUO,PACING=1,VPACING=2 


IPFT2S9L LU 

LOGADDR=12,DLOGMOD=OCSLUO,PACING=1,VPACING=2 


IPFT2S9M LU 

LOGADDR=13,DLOGMOD=OCSDSC,PACING=1,VPACING=2 


IPFT2S9N LU 

LOGADDR=14,DLOGMOD=OCSMD2,PACING=1,VPACING=2 


IPFT2S90 LU 

LOGADDR=15,DLOGMOD=OCSMD2,PACING=1,VPACING=2 


IPFT2S9P LU 

■k 

LOGADDR=16 



Figure 24. VM VTAM LOCAL SNA Major Node for IBM 3174 and RISC/6000 
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5.1.3 Customization in VSE/ESA 

VSE/ESA is installed with the standard Environment 6 partition layout. An ADD 
statement is included in the IPL procedure to define VCTCA: 

ADD 800,CTCA,EML 


5.1.4 Customization in VSE VTAM 

The following VTAM definitions in VSE VTAM are required to implement our 
network configuration: 

• Path table for the cross domain communication with VM VTAM 

• CA major node to define VCTCA 

• CDRM major node to define the cross domain resource managers 

• CDRSC major node to define the CCS II Gateway LUs 


5.1.4.1 VTAM Path Table 

A path is required to enable the cross domain communication from VSE VTAM to 
VM VTAM using VCTCA. The sample job in Figure 25 is used to define and 
catalog the VTAM path table. 


* $$ JOB JNyh=TCPPATH,DISP=D,PRI=3,NTFY=YES,DEST=*,CLASS=0 
// JOB TCPPATH CATALOG VTAM BOOK 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 

CATALOG TCPPATH.B REPLACE=YES 

* PATH TO CONNECT TO VM/ESA 

IPFHWT2 PATH DESTSA=2, C 

ER0=(2,1) ,ER1=(2,1) ,ER2=(2,1) ,ER3=(2,1), C 

ER4=(2,1) ,ER5=(2,1) ,ER6=(2,1) ,ER7=(2,1), C 

VR0=0, VR1=1, VR2=2, VR3=3, VR4=4, VR5=5, VR6=6, VR7=7 

/+ 

/* 

/& 

* $$ EOJ 


Figure 25. VSE VTAM Path Table 

The destination and adjacent subareas must match the host subarea of VM 
VTAM. The transmission group, explicit and virtual routes must correspond to 
the definitions in VM VTAM's path table. 


5.1.4.2 VTAM CTCA Major Node 

The sample job in Figure 26 on page 49 is used to define and catalog VCTCA 
with address 800 to VTAM. 
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* $$ JOB JNiy^TCPCTCA,DISP=D,PRI=3,NIFY=YES,LDEST=*,CLASS=0 
// JOB TCPCTCA CATALOG VTAM CTCA MAJOR NODE 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 
CATALOG TCPCTCA.B REPLACE=YES 

TCPCTCA VBUILD TYPE=CA 
TCPCG800 GROUP LNCTLCTCA 
TCPCL800 LINE ADDRESS=800,ISTATUS=ACTIVE 
TCPCP800 PU PUTYPE=4,TGN=I 
/+ 

/* 

/& 

* $$ EOJ 


Figure 26. VSE VTAM CA Major Node VCTCA 


5.1.4.3 VTAM CDRM Major Nodes 

The sample job in Figure 27 is used to define and catalog the CDRM major 
node. 


* $$ JOB JNiyp=TCPCDRM,DISP=D,PRI=3,NTFY=YES,LDEST=*,CLASS=0 
// JOB TCPCDRM CATALOG VTAM BOOK 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 

CATALOG TCPCDRM.B REPLACE=YES 

TCPCDRM VBUILD TYPE=CDRM 

IPFV2B CDRM SUBAREA=22,CDRDYN=YES,ISTATUS=ACTIVE 
IPFV2 CDRM SUBAREA=2,CDRDYN=NO,ISTATUS=ACTIVE 

/+ 

/* 

/& 

* $$ EOJ 


Figure 27. VSE VTAM CDRM Major Node 


5.1.4.4 VTAM CDRSC Major Nodes 

Listed in Figure 28 on page 50 is the sample job to define the OCS II Gateway 
LUs as cross domain resources. The CDRSC entry names must match the LU 
names defined in the VM VTAM Local SNA major node. 
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* $$ JOB JNiy^TCPCDRS,DISP=D, 

PRI=3,NTFY=YES,LDEST=*,CIASS=0 

// JOB TCPCDRS CATALOG VTAM BOOK 

// EXEC LIBR,PARM=<:MSHP<: 
ACCESS SUBLIB=PRD2.CONFIG 

CATALOG TCPCDRS. B 

REPLACE=YES 

TCPCDRS VBUILD TYPE=CDRSC 

IPFT2S9A CDRSC CDRM=IPFV2 

FOR OCS FTP SERVER 

IPFT2S9B CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9C CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9D CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9E CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9F CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9G CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9H CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9I CDRSC CDRM=IPFV2 

FOR OCS FTP CLIENT 

IPFT2S9J CDRSC CDRiy^IPFV2 

FOR OCS TNFS OUTBOUND 

IPFT2S9K CDRSC CDRiy^IPFV2 

FOR OCS TNFS OUTBOUND 

IPFT2S9L CDRSC CDRiy^IPFV2 

FOR OCS TNFS OUTBOUND 

IPFT2S9M CDRSC CDRM=IPFV2 

FOR OCS TNFS INBOUND 

IPFT2S9N CDRSC CDRM=IPFV2 

FOR OCS TNFS INBOUND 

IPFT2S90 CDRSC CDRM=IPFV2 

FOR OCS TNFS INBOUND 

IPFT2S9P CDRSC CDRiy^IPFV2 

/+ 

/* 

/& 

* $$ EOJ 

FOR OCS SAM APPLICATIONS 


Figure 28. VSE VTAM CDRSC Major Node for OCS II Gateway 


5.2 VSE/ESA with OCS II Gateway Attached via the Token-Ring Adapter 

In this configuration, VSE/ESA communicates directiy with OCS II Gateway via 
the IBM 9221's Token-Ring adapter. To prepare for this connection configuration, 
the foiiowing environments are customized: 

• IBM 9221 Token-Ring adapter 

• VSE/ESA 

• VSE VTAM 

The foiiowing tasks must be performed before the definitions of this configuration 
can be tested: 

• Ensure that the IBM 9221 Token-Ring adapter and OCS il Gateway are 
properiy connected to the same IBM Token-Ring LAN 

• V NET,INACT the OCS II Gateway PU in VM VTAM 

• V NET,iNACT the CDRSC major node in VSE VTAM 

Figure 29 on page 51 provides a summary of the attachment configuration and 
VTAM definitions. Pointers in the diagram iliustrate the reiationships of the 
definitions and where parameter vaiues must matoh. This diagram shouid be 
referred to whiie studying the sample definitions provided in this document. 
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9221 TR Customization 

TCPTR.B LAN Major Node 

TRA Addr 300 

TCPPORT PORT CUADDR=300 

Node Addr 400020201002 

MACADDR=400020201002 

SAPADDR=4 

MAXDATA=0 


TCPTRGl GROUP DIAL=YES.. 

VSE/ESA 

TCPTRLl LINE CALL=INOUT 

IPFP2209 PU 

IPL ADD 300,CETI 


ACF/VTAM 


IHMI TOKEN-RING LAN 


OCS II Gateway 


DLC Defintion: 


Remote Link Address 


400020201002 

TCPSW.B SWNET Major Node 

Remote Link SAP 4 

IPFP2209 PU ADDR=04 

RS/6000 TRA LAA: 


400010101009 

MACADDR=400010101009 

SNA Configuration: 


Data Link Buffer 2048 

MAXDATA=2057 

Station Address 4 

SAPADDR=4 

PU Type 2 

PUTYPE=2 

XID 2017E0009 

IDBLK=017 

IDNUMPEOOOO 

PU IPFP2209 

LU 1 IPFT2S9A 

IPFT2S9A LU LOCADDR=l 

LU 2 IPFT2S9B 

IPFT2S9B LU LOCADDR=2 

LU 16 IPFT2S9P 

IPFT2S9P LU LOCADDR=16 


Figure 29. Configuration and Definition Summary for the TRA Connection 
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5.2.1 Customization of IBM 9221 Token-Ring Adapter 

The unit and node address of the Token-Ring adapter are customized at the IBM 
9221 processor consoie, using the foiiowing steps: 

1. Log on as system programmer (SYSPROG) 

2. Seiect 'Customize' from the action bar 

3. Seiect 'I/O Controller' 

4. Seiect 'Change Customization' from the 'Action' option 

5. Specify '00' for the unit address 

6. Specify '400020201002' for the node address 

7. Specify the correct ring speed 

After the customization, the Token-Ring adapter must be re-initiaiized with the 
new data. This is accompiished by the 'Reconfigure the Adapter' option from the 
'Customize I/O Controller' function. 


5.2.2 Customization in VSE/ESA 

The customization in VSE/ESA invoives two tasks: 

• Taiior the VSE/ESA user directory (for the VM/VSE environment) 

• Taiior the IPL procedure to define the Token-Ring adapter 

5.2.2.1 VSE/ESA User Directory 

Since VSE/ESA is running under VM in our iab environment, the foiiowing 
commands are required in the VSE/ESA user directory: 

• DEDICATE 300 0300. Dedicates the CETI group address to VSE/ESA 

• DEDICATE 301 0301. Dedicates the CETI group address to VSE/ESA 

• DEDICATE 302 0302. Dedicates the CETI group address to VSE/ESA 

• DEDICATE 303 0303. Dedicates the CETI group address to VSE/ESA 

This customization step is not required if VSE/ESA is running in native mode. 

5.2.2.2 VSE/ESA IPL Procedure 

An ADD statement is inciuded in the iPL procedure to define the Token-Ring 
adapter: 

ADD 300,CETI 
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5.2.3 Customization in VSE VTAM 

To support the attachment configuration, the foliowing VTAM definitions are 
required in VSE VTAM: 

• A LAN major node to define the IBM Token-Ring LAN 

• A Switched major node to define the OCS II Gateway 


5.2.3.1 VTAM LAN Major Node 

The LAN major node in Figure 30 is used to define the Token-Ring adapter and 
OCS li Gateway PU attached on the iBM Token-Ring LAN. 


* $$ JOB JNiyh=TCPTR,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS=A 
// JOB TCPTR 

// EXEC LIBR,PARiy^<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 
CATALOG TCPTR.B REPLACE=YES 


* LAN MAJOR NODE * 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 


TCPTR VBUILD TYPE=LAN 

■k 

* DEFINITION FOR 9221 TRA 
TCPPORT PORT CUADDR=300, 

MACADDR=400020201002, 
LANCON=(02.0,2), 
MAXDATA=0, 

MAXSTN=60, 

SAPADDR=4 

■k 

* DEFINITION FOR RS/6000 


PORT ADDRESS C 
LAA FOR 9221 TRA C 
TIMER AND RETRY COUNT C 
SET TO 0 FOR MAX FRAME SIZE C 

C 


SERVICE ACCESS POINT ADDRESS 


TCPTRGl GROUP DIAL=YES, LNCTL=SDLC 
TCPTRLl LINE ISTATUS=ACTIVE,CALL=INOUT 
IPFP2209 PU ISTATUS=ACTIVE 
/+ 

/* 

/& 

* $$ EOJ 


Figure 30. VSE VTAM LAN Major Node 


The key parameters are: 

• CUADDR of the PORT macro. Must match the hardware address defined in 
the IBM 9221 and VSE ADD statement. 

• MACADDR of the PORT macro. The medium access controi (MAC) address 
of the iBM 9221 Token-Ring adapter. It must match the Node Address 
defined in the IBM 9221, and the Remote Link Address defined in the OCS II 
Gateway customization. 

• MAXDATA of the PORT macro. The maximum iength of the information fieid 
of an LPDU on the LAN. We set this vaiue to 0, to aiiow for the maximum 
frame size supported by the iBM 9221 Token-Ring adapter. 
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• SAPADDR of the PORT macro. The service access point (SAP) address of 
this PU. The value must be a multiple of four and must match the remote link 
SAP in the OCS II Gateway customization. 

• PU Name IPFP2209. The name of this PU. It must match the PU name in the 
Switched major node and OCS II Gateway. 


5.2.3.2 VTAM Switched Major Node 

A Switched major node is used to define the OCS II Gateway PU and LUs 
attached on the IBM Token-Ring LAN. Listed in Figure 31 on page 55 is an 
extract from the definition job, to highlight the key PU parameters. The complete 
Switched major node definition job is listed in A.3, “VSE TCPSW.B Switched 
Major Node” on page 342. 

The LU parameter values are determined by the OCS applications. They are 
discussed in the following sections: 

• 6.2, ‘‘OC/FTP Server Customization” on page 64 

• 7.2, “OC/FTP Client Customization” on page 82 

• 10.2, “OC/TELNET FS Customization” on page 134 
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TCPSW 


VBUILD TYPE=SWNET 


* PU AND LU DEFINITION FOR OCS II GATEWAY 

:*r 

IPFP2209 PU ADDR=04,MACADDR=400010101009, LAA FOR RS/6000 C 

IDBLK=017, IDENTIFICATION BLOCK C 

IDNUiy^E0009, IDNUM SET BY ITSC CONVENTION C 

PACING=0,VPACING=0, NO PACING FOR OCS FTP C 

PUTYPE=2, PU-2 REQUIRED BY OCS GATEWAY C 

MAXDATA=2057, FROM 265 TO 2057 C 


SAPADDR=4 SERVTCE ACCESS POINT ADDRESS 

* LU DEFINITION FOR RS/6000 GATEWAY 

■k 

* 9A FOR FTP SERVER, 9B-I FOR FTP CLIENT 

* 9J-L FOR TELNET CLIENT, 9M-0 FOR TELNET SERVER 

* 9P FOR SAM SAMPLE PROGRAMS 


IPFT2S9ALU LOCADDR=1,DLOGMOD=OCSLUO,LOGAPPIKX:SFTPS, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

MDLTAB=VTiyiyDL,MDLENT=VSELU2A, C 

SSCPFiyi=USSSCS, USSTAB=VTMUSSTR 

IPFT2S9B LU LOCADDR=2,DLOGMOD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

MDLTAB=VTiyiyDL,MDLENT=VSELU2A, C 

SSCPFiyi=USSSCS, USSTAB=VTMUSSTR 

IPFT2S90 LU LOCADDR=I5,DLOGMOD=OCSMD2, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, c 

MDLTAB=VTMMDL,MDLENT=VSELU2A, c 

PACING=1,VPACING=2, c 

SSCPFiyi=USSSCS, USSTAB=VTMUSSTR 

IPFT2S9P LU LOCADDR=16,DLOGMOD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, c 

MDLTAB=VTMMDL,MDLENT=VSELU2A, c 

SSCPFiyi=USSSCS, USSTAB=VTMUSSTR 


Figure 31. VSE VTAM Switched Major Node Definition 
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The key PU parameters are: 

• PU name. The name of the PU. It must match the name specified in the LAN 
major node and OCS II Gateway customization. 

• MACADDR. The MAC address of the RISC/6000 Token-Ring adapter. It must 
match the Token-Ring adapter address defined in the RISC/6000. 

• IDBLK. A three-digit hexadecimal number to identify the device. A value of 
'017' is required by OCS li Gateway. 

• IDNUM. A user assigned five-digit hexadecimai number to identify the 
device. It must match the IDNUM specification in the 'PU Definition' panei of 
the OCS il Gateway customization. 

The PU type, IDBLK and IDNUM make up the XID field in the OCS II Gateway 
configuration. Please refer to Figure 136 on page 179 for details. 

• PACING and VPACING. LU pacing parameters to control the VTAM pacing 
values between LUs. They are placed in the PU to allow the specifications to 
sift-down to the LUs. Both parameters are set to 0 for the FTP LUs. These 
values are everridden in the OC/TELNET FS LUs definition. 

• PUTYPE. The PU type ef this contreller. PU type 2 is required by OCS II 
Gateway. 

• MAXDATA. The maximum PIU size that this PU can receive. The value is 
the maximum RU size plus nine bytes (fer the TH and RH). The maximum 
RU size must match the data link buffer size in the OCS II Gateway 
configuration listing. Please refer to 12.4.6, “Generate a Configuration 
Listing” on page 178 for the configuration listing. 

• SAPADDR. The SAP address of this PU. It must match the station address 
in the OCS II Gateway customization. 


5.3 VSE/ESA with OSCII Gateway Attached via the OCC 

In this configuration, VSE/ESA communicates directly with OCS II Gateway via 
the OpenConnectien for Channel adapter. To prepare for this connection 
configuration, the following environments are customized: 

• OpenConnectien for Channel 

• VSE/ESA 

• VSE VTAM 

Figure 32 on page 57 provides a summary of the attachment configuration and 
VTAM definitions. This diagram should be referred to while studying the sample 
definitions provided in this document. 
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9221 

Channel Address 2201 

VSE/ESA 

IPL ADD 901,3791L 

ACF/VTAM 

IPFT2901 PU CUADDR=901 
IPFT2S9A LU LOCADDR=l 

IPFT2S9P LU LOCADDR=16 

Channel 

OCC 

SCSI 

CCS II Gateway 

SCA Definitions 

PU IPFP2901 
LU 1 IPFT2S8A 

LU 16 IPFT2S9P 

Data Link Buffer 265 
Station Address 4 
PU Type 2 


Figure 32. Configuration and Definition Summary for the OCC Connection 
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5.3.1 Customization of OpenConnection for Channei 

The OpenConnection for Channel adapter configuration consists of the following 
steps: 

• Configure the OCC adapter by selecting the OCC SCSI address (4) using the 
OCC front panel menu. 

• Configure OCC Hardware in the AIX operating system using SMIT. 

For detailed information on the OCC hardware configuration please see 16.1.3, 
“Configuring OCC Hardware” on page 210. 


5.3.2 Customization in VSE/ESA 

The customization in VSE/ESA involves two tasks: 

• Tailor the VSE/ESA user directory (for the VM/VSE environment) 

• Tailor the IPL procedure to define the OpenConnection for Channel 

5.3.2.1 VSE/ESA User Directory 

Since VSE/ESA is running under VM in our lab environment, the following 
command is required in the VSE/ESA user directory: 

• DEDICATE 901 2201. Dedicates the device address to VSE/ESA 

This customization step is not required if VSE/ESA is running in native mode. 


5.3.2.2 VSE/ESA IPL Procedure 

An ADD statement is included in the IPL procedure to define OpenConnection for 
Channel: 

ADD 901,3791L 


5.3.3 Customization in VSE VTAM 

To support the attachment configuration, the following VTAM definition is 
required in VSE VTAM: 

1. A PU definition to define the channel. 

The PU in Figure 33 on page 59 is used to define the OpenConnection for 
Channel. 
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Figure 33. PU Definition for the OCC Connection 
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Chapter 6. OC/FTP Server Installation and Customization 


This chapter covers the installation and customization of OC/FTP Server. It 
consists of two steps: 

1. Installation - Describes the preparation and procedures to Install OC/FTP 
Server In VSE/ESA 

2. Customization - Provides a detailed explanation of the product customization 


6.1 OC/FTP Server Installation 

There are two major steps involved to Install the product: 

1. Prepare the Installation environment for the product 

2. Install the product from tape to the VSE/ESA sublibrary 


6.1.1 Prepare the Installation 

The installation preparation for OC/FTP Server involves the definitions of: 

• OCS 11 Gateway to VSE/ESA 

Please refer to Chapter 5, “Defining the OCS 11 Gateway to the Host” on 
page 41 for the setup instructions. 

• The VSE/ESA library and sublibraries for the product Installation 

Library TCPOCS is defined using the VSE/ESA Interactive Interface (II) 

'Define a Librar/ panel. 

Subllbrary TCPOCS.FTPS is defined using the LIBR DEF SUB command in 
ICCF. This sublibrary is used to store the OC/FTP Server product, and the 
FTP server customization. 

• VSE/ESA user sublibraries for the FTP clients 

This is an optional step. The numbers and names of the sublibraries to be 
used depend on the installation's requirements. You may define as many 
user sublibraries as needed, and assign them to the FTP clients. The default 
assignment for the FTP clients is discussed in 6.2.3.2, “SITE Member” on 
page 69. 

We defined the following user sublibraries for our FTP clients: 

TCPOCS.USER, TCPOCS.USR1, TCPOCS.USR2, TCPOCS.USR3, 

TCPOCS.USR4, TCPOCS.USR5, TCPOCS.USR6, TCPOCS.USR7, 

TCPOCS.USR8, TCPOCS.USR9, and TCPOCS.USR10. 

Figure 34 on page 62 illustrates the TCPOCS library information that we 
defined. The space utilization of the OCS products may vary from release to 
release, and you should not use it for your library space estimation. 

• Changes 

Any necessary/optional changes to your system are marked by "$CHGOPT$" 
for optional, and "$CHGREQ$" for required modifications. These changes are 
for system configurations, and MUST be completed, where mandatory. 


© Copyright IBM Corp. 1995, 1996 
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0 LD L=TCPOCS 0=ST 







BG 0000 







BG 0000 STATUS DISPLAY 

LIBRARY=TCPOCS 


DATE: 

96-07-04 

BG 0000 





TIME: 

11:54 

BG 0000 - 







BG 0000 FILE-ID 

: VSE.TCPOCS.LIBRARY 





BG 0000 CREATION DATE 

: 96-05- 

29 13:13 





BG 0000 SUBLIBRARIES 


26 





BG 0000 







BG 0000 LOCATION (VSAM) : DEVICE 

=9336 VOLID= 

=SYSWK1 BLK# = 

242176 - 

272895 

BG 0000 

DEVICE 

=9336 VOLID= 

=SYSWK1 BLK# = 

281472 - 

292031 

BG 0000 

DEVICE 

=9336 VOLID= 

=SYSWK1 BLK# = 

292032 - 

302591 

BG 0000 







BG 0000 LIBRARY BLOCK : SIZE= 

1024 BYTES 

DATA SPACE= 

988 BYTES 

BG 0000 







BG 0000 TOTAL SPACE : 25920 LIBRARY BLOCKS 

(100 %) 



BG 0000 USED SPACE : 10214 LIBRARY BLOCKS 

( 39 %) 



BG 0000 DELAYED SPACE 

: 364 LIBRARY BLOCKS 

( 1 %) 



BG 0000 FREE SPACE : 15342 LIBRARY BLOCKS 

( 60 %) 



BG 0000 







BG 0000 - 







BG 0000 SUBLIBRARY 

CREATION 

SPACE NO. OF 

USED 

DELAYED 

% LIBR. 

BG 0000 

DATE 

REUSAGE MEMBERS 

LBtS 

LB-fS 

SPACE 

BG 0000 - 







BG 0000 FTPC 

96-05-29 

AUTO 

95 

1446 

0 

6 % 

BG 0000 FTPS 

96-05-29 

AUTO 

100 

1299 

2 

5 % 

BG 0000 HUGO 

96-05-29 

IMMED 

1 

2 

0 

0 % 

BG 0000 LPD 

96-05-29 

AUTO 

37 

547 

0 

2 % 

BG 0000 PARMLIB 

96-06-17 

AUTO 

11 

185 

362 

2 % 

BG 0000 RSH 

96-05-29 

AUTO 

36 

478 

0 

2 % 

BG 0000 SAMMAC 

96-06-24 

AUTO 

176 

527 

0 

2 % 

BG 0000 SAMOBJ 

96-06-24 

AUTO 

101 

818 

0 

3 % 

BG 0000 SAMSMP 

96-06-24 

AUTO 

96 

647 

0 

2 % 

BG 0000 TNFS 

96-05-29 

AUTO 

622 

3504 

0 

14 % 

BG 0000 USER 

96-05-29 

AUTO 

17 

735 

0 

3 % 

BG 0000 USRl 

96-05-29 

AUTO 

2 

8 

0 

0 % 

BG 0000 USRIO 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR2 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR3 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR4 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR5 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR6 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR7 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR7 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR8 

96-05-29 

AUTO 

0 

1 

0 

0 % 

BG 0000 USR9 

96-05-29 

AUTO 

0 

1 

0 

0 % 


Figure 34. VSE/ESA Library and Subiibraries for OCS Products 

• VSAM catalog and space definitions for the FTP clients 

A VSAM catalog named TCPCAT is defined using the VSE/ESA II 'Define a 
New User Catalog' panel. VSAM space is defined to the catalog using the 
VSE/ESA II 'Display or Process a Catalog, Space' panel. 

This is an optional step. We defined the catalog to hold user VSAM data sets 
for the FTP clients. You may define a new or use an existing catalog for the 
FTP clients, depending on the installation's requirements. You may assign 
the catalog to the FTP clients as a default catalog. The default assignment 
for the FTP clients is discussed in 6.2.3.2, “SITE Member” on page 69. 
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6.1.2 Installation Procedures 

Installation of the product from tape to the product sublibrary involves the 
follewing steps: 

• Use the VSE/ESA II 'Prepare for Installation (Stacked Tapes Only)' panel to 
generate the job to scan the product tape, as illustrated in Figure 35. 


* $$ JOB JM'#<X:SPRE,DISP=H,PRI=3,NIFY=YES,LDEST=*,CLASS=0 
// JOB OCSPRE SCAN OPTIONAL PRODUCT TAPE 

// LIBDEF PHASE,SEARCH= (PRDl.BASE, IJSYSRS.SYSLIB) 

■k k 

* * PREPARE ADDITIONAL PROGRAM INSTALLATION 

* * - SCAN PROGRAM TAPE 

k k 

// ASSGN SYS006,184 

// EXEC DTRIPRE,PARM=<:ADDR=184<: 

/* 

/& 

* $$ EOJ 


Figure 35. Sample Job to Scan Product Tapes 

• Submit the job to VSE/ESA and review the library space requirements of the 
preduct. 

• Use the VSE/ESA II 'Install Product(s) from Tape' panel to generate the job to 
install the product into sublibrary TCPOCS.FTPS. 

- Note - 

With OC/FTP software Version 2.2 and later, both OC/FTP Client and 
OC/FTP Server can be leaded into the same library.sublibrary 


The VSE/ESA II panel also displays the minimum library space requirements 
for the product. 

• Submit the jcb to VSE/ESA to install the product. Our installation step took 
less than 10 minutes. 

There is no installation verification job provided by the software. You may use 
the sample job in Figure 36 on page 64, to verify that the product is recorded by 
MSHP. Testing of the product can only be performed after the product 
customization. Please refer tc Chapter 18, “OC/FTP Server Operation and 
Examples” on page 219 for the testing and operatien procedures. 
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* $$ JOB JNiy^RETRACE,DISP=D,PRI=9,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB RETRACE 

* _ 

* RETRACE PRODUCTS **** FROM SYSTEM HISTORY FILE 

★ _ 

// ASSGN SYS018,DISK,VOIf=DOSRES,SHR 
// DLBL IJSYSHF, WSE.SYSTEM.HISTORY.FIIEC, 99/365, SD 
// EXTENT SYSOI8,DOSRES, 1,0,6135,75 
// EXEC MSHP 

RETRACE PRODUCTS 

/* 

/& 

* $$ EOJ 


Figure 36. Sample Retrace Product Job 


6.2 OC/FTP Server Customization 

The customization is based on the sampies in PRODBLDS.PROC provided by 
OC/FTP Server. After the product is instalied in the product subiibrary, 
PRODBLDS.PROC is punched into an ICCF library, using the following command 
from your VSE/ICCF command mode screen: 

LIBRP TCPOCS.FTPS PRODBLDS.PROC PRODBLDS 

We then edited it into individual jobs to tailor the OC/FTP Server environment. 

The OC/FTP Server customization consists of four steps: 

• VSAM customization 

• VTAM customization 

• FTP Server customization 

• Startup customization 


6.2.1 VSAM Customization 

When an FTP client wants to put a file into a VSAM file, OC/FTP Server requests 
VSAM to implicit-define the file in the catalog assigned. VSAM implicit-define 
requires a model in the catalog to define the data set. It will use the respective 
ESDS, SAM or KSDS model for the definition according to the file type needed. 

The job in Figure 37 on page 65 defines models to the catalog 
TCPIP.USER.CATALOG. 
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* $$ JOB JNI>t=DEFMDL,DISP=D,CLASS=A 

// JOB DEFMDL - DEFINE DEFAULT MODEL FOR ESDS, SAM & KSDS 
// EXEC POy^IDCAMS, SIZE=IDCAMS 

DEFINE CLUSTER (NAME (DEFAULT. MODEL. ESDS) + 
RECORDSIZE(8 8) + 

RECORDS(8 8) + 

VOLUMES(SYSWK4) /* $CHGOPT$ */ + 

NOALLOCATION NERAS NIXD RUS SHR(2 4) SPEED) + 

DATA (NAME (DEFAULT. MODEL. ESDS. DATA)) + 

CATALOG(TCPIP.USER.CATALOG) 

/* */ 

DEFINE CLUSTER (NAME (DEFAULT. MODEL. ESDS. SAM) + 
RECORDFORMAT(U) + 

RECORDSIZE(8 8) + 

RECORDS(8 8) + 

VOLUMES(SYSWK4) /* $CHGOPT$ */ + 

NOALLOCATION NERAS NIXD RUS SHR(2 4) SPEED) + 

DATA (NAME (DEFAULT. MODEL. ESDS. SAM. DATA)) + 

CATALOG(TCPIP.USER.CATALOG) 

/* */ 

DEFINE CLUSTER (NAME (DEFAULT. MODEL. KSDS) + 
RECORDSIZE(8 8) + 

RECORDS(8 8) + 

VOLUMES(SYSWK4) /* $CHGOPT$ */ + 

KEYS(1 0) + 

NOALLOCATION NERAS IXD RUS SHR(2 4) SPEED) + 

DATA (NAME (DEFAULT. MODEL. KSDS. DATA)) + 

INDEX (NAME (DEFAULT. MODEL. KSDS. INDEX)) + 

CATALOG(TCPIP.USER.CATALOG) 

/* 

/& 

* $$ EOJ 


Figure 37. ESDS, SAM and KSDS Model Definitions for OC/FTP Server 

The key parameters to tailor are: 

• RECORDSIZE. The most commonly used record length. 

• RECORDS. The primary and secondary space allocation. 

• RECORDFORMAT. The record format of the VSAM SAM file. 

• KEYS. The keylength and key start position of the VSAM KSDS file. 

• CATALOG. The user catalog name assigned. 

The VSAM data set definition parameters may be overridden by the SITE 
member and command. Please refer to 6.2.3.2, “SITE Member” on page 69 and 
Chapter 18, “OC/FTP Server Operation and Examples” on page 219 for details. 

If you are using the VSAM.USER.CATALOG, do not delete/define the VSAM 
ESDS.SAM model cluster. It is already defined during VSE/ESA installation and 
used as workfile. 
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6.2.2 VTAM Customization 

The following customization tasks are required in VTAM: 

• Define the logmode table and entry for the application and LU 

• Specify the APPL definition for OC/FTP Server 

• Add the LU definition for the OCS II Gateway LU 


6.2.2.1 Logmode Table OCSBIND 

The sample job listed in A.6, “OCSBIND MODETAB for OCS Products” on 
page 351 creates the OCSBIND logmode table. There are three entries in this 
table used by the OCS products. OC/FTP Server uses the entry listed in 
Figure 38: 


OCSLUO MODEENT LOOMDDEKX/SLUO, 

c 

EMPROF=X<:06<:, 

c 

TSPROF=X<:03<:, 

c 

PRIPROT=X<:00<:, 

c 

SECPROT=X<:00<:, 

c 

CCMPROT=X<:0000<:, 

c 

RUSIZES=X<:F8F8<:, 

PSERVIC=X<:000000000000000000000000<: 

c 


Figure 38. MODETAB Entry for OC/FTP Server 


6.2.2.2 VTAM APPL Definition 

The completed VTAM APPL major node definition is listed in A.4, “VTAM APPL 
Major Node for OCS Products” on page 344. 

The APPL entry below is used by OC/FTP Server: 


OCSFTPS APPL iyDDETAB=OCSBIND,DLOGiyDD=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 

Figure 39. VTAM APPL Statement for OC/FTP Server 
Key parameters are: 

• MODETAB and DLOGMOD. Identify the appropriate logmode table entry. 

• NVPACE in AUTH parameter. Turns off VTAM pacing for FTP. 

• ACQ in AUTH parameter. Allows OC/FTP Server to acquire LUs. 

• EAS=2. Allows two concurrent sessions for OC/FTP Server. 

6.2.2.3 VTAM LU Definition 

The completed OCS II Gateway LUs definition is listed in Figure 24 on page 47 
and A.3, “VSE TCPSW.B Switched Major Node” on page 342. 

Figure 40 on page 67 lists the LU definitions used by OC/FTP Server: 
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IPFT2S9A LU 

L0CADDR=1, DLOGiyDD=OCSLUO, LOGAPPIKX/SFTPS, 

C 


ISTATUS=ACTIVE, iyDDETAB=OCSBIND, 

C 


iyDLTAB=VIMyDL, iyDLENT=VSELU2A, 

C 


SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 



Figure 40. Logical Unit Definition for OC/FTP Server 
The key parameters are: 

• LU name. Must match the LU name in the OCS II Gateway customization. 

• LOCADDR. Must match the LU number in the OCS 11 Gateway customization. 

• MODETAB and DLOGMOD. Identify the appropriate logmode table entry. 

• LOGAPPL. Logs on to OC/FTP Server when the LU Is activated. 


6.2.3 FTP Server Customization 

The following members are tailored for the FTP server function of OC/FTP 
Server: 

• CONFIG. Relates the FTP server function to VTAM, and defines the TCP/IP 
port used by OC/FTP Server. 

• SITE. Defines the default FTP file values. 

• PASSWD. Defines the FTP user IDs and default working environments. 

These three members are filed in sublibrary TCPOCS.FTPS. 

The alternative to using the product library is to define a Parameter Library as a 
VSE librarian sublibrary. We defined TCPOCS.PARMLIB to catalog the 
OpenConnect products' configuration members. The OpenConnect Applications, 
such as OC/TELNET FS, OC/FTP Server, OC/FTP Client, OC/LPD, OC/SAM, and 
OC/RSH are using the same members for the site configuration. Defining a 
single parameter library will reduce installation and maintenance effort, as only 
the necessary entries for the application programs need to be added. The 
following DLBL statement specifies the parameter library, used with FTP Client 
and OC/LPD: 


// DLBL name,'/LLbrarry.sublibrarry.rTBtribertype'/ 
// DLBL Or,.SPT ,TB, CTCPOC-S. PAR MT ,TR . FTPC 


Figure 41. Parameter Library DLBL 


6.2.3.1 CONFIG Member 

The CONFIG member is used to define the VTAM ACB name, TCP/IP FTP port 
number and the pacing values. 

Figure 42 on page 68 lists the job we tailored: 
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* $$ JOB JNiy^SFCONFIG,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB SFCONFIG 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPS 

CATALOG CONFIG. TCP IP EOD=$$ REPLACE=Y 


ACBNAME 

OCSFTPS 

DEFAULT VTAM ACB NAME 

ETRACE 

NO 

INITIAL TRACE VALUE 

PORT 

21 

CCMMUNICATION PORT FOR FTP SERVER 

PACEIN 

50 

INBOUND PACING 

PACEOUT 

50 

OUTBOUND PACING 


$$ 

/* 

/& 

* $$ EOJ 


Figure 42. CONFIG Member for OC/FTP Server 
The key parameters are: 

• ACBNAME. Relates the FTP server function to VTAM. It must match the 
name defined for OC/FTP Server in the VTAM APPL statement. 

• ETRACE. Trace of packet option. You can also turn on the trace from the 
FTP session using the FTP client command - 'trace on'. All the packet trace 
output will be appended to the output of the OC/FTP Server startup job. 

• PORT. Specifies the OC/FTP Server listen port. We have used the TCP/IP 
standard FTP listen port 21 for the VSE OC/FTP Server. If you also want to 
access the AIX's FTP Server, you need to change the listen port number of 
the AIX FTP Server. Flow to set up the AIX FTP Server to use another listen 
port number is described in 12.6, “Set up Alternative Ports for AIX TELNET 
and FTP Servers” on page 186. 

If you set up this port number to be a number greater than 2000, the AIX FTP 
Server port number can be left unchanged with the standard FTP listen port 
21. However, from an FTP Client, you need to specify the port number when 
you open an FTP session to the VSE OC/FTP Server. 

So, keep in mind that the port number for the VSE and AIX FTP Servers have 
to be different. In our case, we preferred to connect to the VSE FTP Server 
without specifying a port number. 

• PACEIN and PACEOUT. These two parameters are used to implement 
application pacing between the OC/FTP Server programs in the host and 
OCS II Gateway control unit. 

Pacing is the mechanism to control and limit the traffic flow between senders 
and receivers. It is important for some network functions that have the 
potential to use a lot of network resources, if uncontrolled. FTP may transfer 
large files over the network, and is considered a candidate for pacing 
control. 

The OCS pacing implementation is conceptually similar to the VTAM 
one-stage pacing between LUs. Note that it is implemented at the 
application level, and does not affect VTAM pacing. It allows the user to limit 
the traffic between OC/FTP Server and OCS II Gateway, in addition to the 
VTAM LU-LU pacing. 

- PACEIN 
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Defines the number of RUs OCS II Gateway may send to OC/FTP Server, 
before waiting for a pacing response from OC/FTP Server. 

PAGEOUT 


Defines the number of RUs OC/FTP Server may send to OCS II Gateway, 
before waiting for a pacing response from OCS II Gateway. OCS II 
Gateway will not return the pacing response until the data Is sent to the 
TCP/IP end node. 

In general, it is more important to control the outbound pacing for the 
following reasons: 

- The resources (for example, cycles and data buffers) are limited In OCS 
II Gateway 

- Usually the data flow between OC/FTP Server and OCS II Gateway Is 
faster than within the TCP/IP network 

• FTPSXIT1. Specify YES or NO for the user's Access Control Exit. OC/FTP 
Server library comes with a sample program 'FTPSXIT1 .SAMPLE'. You can 
modify this program for example to: 

- Send messages to specific users when they log on 

- Restrict a specific user(s) from logon 

- Compute the logon duration of user(s) 

- Restrict access to VSAM, Libraries and POWER queues 

If YES is specified this phase will be loaded at the start of the FTP session 
and deleted when the session ended. 

The default for FTPSXIT1 is NO. 


6.2.3.2 SITE Member 

The SITE member is used to override the OC/FTP Server default values for the 
VSAM, VSE/ESA library and POWER environment. The default values are used 
for the VSAM implicit-define and file transfer, if they are not overridden by the 
TCP/IP FTP clients using the OUOTE SITE command. Please refer to 18.1.2, 
“TCP/IP FTP Clients” on page 220 for the explanation of the QUOTE SITE 
command. 

The parameters, descriptions and default values provided by OC/FTP Server are 
listed in Table 5 on page 70. 

Figure 43 on page 70 lists the job we tailored for our environment. 

- Error in SITE member - 

We were unable to specify the new VSAM-KSDS and VSAM-SAM parameters. 
When we specified parameters such as CISIZEDATA or KEYLENGTH in the 
SITE member, we received a SITE parameter error during OC/FTP Server 
startup. 
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Note 


If errors are found in the SITE member, the entire member is ignored and the 
default values are used. 


Parameter 

Description 

Default 

CATALOG 

Default VSAM catalog 

VSESPUC 

PALLOC 

The primary record allocation for VSAM implioit-define 
ESDS 

512 

SALLOC 

The secondary record allocation for VSAM 
implioit-define ESDS 

256 

VSAMRECL 

The maximum VSAM record length 

256 

CISIZE 

The VSAM Cl size used for ESDS 

4096 

MBRTYPE 

The default LIBR member type 

TCPIP 

RDRCLASS 

The default POWER job class 

A 

LSTCLASS 

The default POWER LST class 

A 

PUNCLASS 

The default POWER PUN class 

A 

LSTFORM 

The default POWER LST form number 


PUNFORM 

The default POWER PUN form number 


RDRPRI 

The default POWER job priority 

3 

LSTPRI 

The default POWER LST priority 

3 

PUNPRI 

The default POWER PUN priority 

3 

SYSID 

The default SYSID for POWER 

N 

UPCASE 

Data translated to upper case for POWER 

YES 

RESTART 

The default restart specification 

OFF 


Table 5. SITE Member Parameters and Default Values 


* $$ JOB JNiy^SFSITE,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS=A 
// JOB SFSITE 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPS 
CATALOG SITE.TCPIP EOD=$$ REPLACE=Y 


CATALOG 

TCPCAT 

DEFAULT VSAM CATALOG 

PALLOC 

1024 

DEFAULT PRIMARY ALLOCATION IN RECORD 

SALLOC 

512 

DEFAULT SECONDARY ALLOCATION IN RECORD 

VSAMRECL 

132 

DEFAULT VSAM RECORD LENGTH 

CISIZE 

4096 

DEFAULT VSAM CISIZE FOR DATA 

$$ 



/* 



/& 




* $$ EOJ 


Figure 43. SITE Member for OC/FTP Server 

Key parameters we tailored are: 

• CATALOG. Defines the user catalog in our environment. 

• PALLOC. Increases the VSAM primary allocation to 1000 records. 
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• SALLOC. Increases the VSAM secondary allocation to 500 records. 

• VSAMRECL. Sets the maximum file record length as 132. 

• CISIZE. Reduces the VSAM Cl size to 4K. 

6.2.3.3 PASSWD Member 

The PASSWD member is used to define the FTP client user IDs and their default 
working directories. The command in the PASSWD member has the following 
syntax: 

Userid Password [LIBR [library[.sublibrary]]] 

Userid Password [VSAM [oatalog [PREFIX node[.node ]]]] 

Userid and Password are required parameters to which you assign user names 
and passwords. The maximum length for both parameters is 32 characters. The 
other parameters are optional. 

LIBR and VSAM are aooess modes for the user: 

• LIBR for VSE/ESA library access. 

It may be followed by an optional library or library.sublibrary name. 

If library or library.sublibrary name is specified, it becomes the default 
working directory when this user logs on to OC/FTP Server. 

• VSAM for VSAM files access. 

It may be followed by an optional catalog name and/or PREFIX nodes. 

If a catalog name is specified, it becomes the default catalog for the user. 

Keyword PREFIX specifies the file node prefix to be used as the default 
working directory for this user. For example, if we have the following files in 
the catalog: 

TESTING.FILE1 

TESTING.FILE2 

TESTING.FILE3 

TESTING.FILE4 

TESTING.FILES 

We oan use the PREFIX keyword followed by 'TESTING'. This specification 
defines TESTING as the working direotory when users log on to OC/FTP 
Server. 

- Error in PASSWD member - 

We specified access mode VSAMKSD for a user ID; when this user logged on 
to OC/FTP Server, he got access mode VSAMSAM instead. This is also true 
for aocess mode VSESAM. Therefore, the user profile in the PASSWD 
member should still adhere to the old version's format. The new VSAM 
features have not been added. 


The user IDs we defined are listed in Figure 44 on page 72. The user IDs and 
passwords should not normally be the same. It is set this way in our 
environment for ease of operation. 
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• User ID USER has library TCPOCS as the default library 

• User IDs USR1-USR7 use library access and have their own sublibraries 
assigned 

• User ID USR8 uses VSAM access, and has no default working directory 
assigned 

• User ID USR9 uses VSAM access. The default catalog is TCPCAT, and the 
working directory assigned is VTMBK 

• User ID USR10 uses VSAM access and has VSESPUC as a default catalog 

• User IDs JYIU, KAMI, MARU, PRAM and WACK use library access and have 
TCPOCS as the default library 

• User ID NEWUSER ANYPSWD VSAM VSESPUC will allow VSE/Interactive 
Interface user additions without the need to synchronize the PASSWD 
member. 


* $$ JOB JNiy^SFPASSW,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS=A 
// JOB SFPASSW 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPS 

CATALOG PASSWD. TCP IP EOD=$$ REPLACE=Y 

■k 

* NAME PASSWORD (LIBR LIB.SUBLIB ] VSAM CATALOG) 

■k 

USER USER LIBR TCPOCS 
USRl USRl LIBR TCPOCS.USRl 
USR2 USR2 LIBR TCPOCS.USR2 
USR3 USR3 LIBR TCPOCS.USR3 
USR4 USR4 LIBR TCPOCS.USR4 
USR5 USR5 LIBR TCPOCS.USR5 
USR6 USR6 LIBR TCPOCS.USR6 
USR7 USR7 LIBR TCPOCS.USR7 
USR8 USR8 VSAM 

USR9 USR9 VSAM TCPCAT PREFIX VTMBK 
USRIO USRIO VSAM VSESPUC 
JYIU BYIU LIBR TCPOCS 
KAMI KAMI LIBR TCPOCS 
MARU MARU LIBR TCPOCS 
PRAM PRAM LIBR TCPOCS 
WACK WACK LIBR TCPOCS 
NEWUSER ANYPSWD VSAM VSESPUC 
$$ 

/* 

/& 

* $$ EOJ 


Figure 44. PASSWD Member for OC/FTP Server 
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Security Note 


Note that the PASSWD member cannot have encrypted passwords. The 
member is a plain text file with all the user entries. 

OCS supports the standard VSE/ACF interface, you can restrict the user from 
accessing unauthorized VSAM and Library files during his or her FTP 
session. To be able to use the VSE/ACF interface, you have to code 
DTSECTAB table and SET SEC=YES during the IPL of VSE. For more 
information on implementing the VSE/ACF interface, please refer to the 
appropriate VSE documentation. 

On the other hand, if you have modified the user's Access Control program 
'FTPSXIT1' to reflect your specific environment, you can easily turn on this 
type of security from the CONFIG member. Please refer to 6.2.3.1, “CONFIG 
Member” on page 67. 


6.2.4 Startup Customization 

The following preparation tasks are required to bring up OC/FTP Server: 

• Build the executable phases 

• Run the site protection modification job 

• Create the FTP Server startup job 


6.2.4.1 Build the Executable Phase 

Figure 45 on page 74 lists the job we used to assemble and link-edit the OC/FTP 
Server phases into the TCPOCS.FTPS sublibrary. The source of this job is 
obtained from PRODBLDS.PROC. 
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* $$ JOB JNiy^SFASMl,CLASS=A,DISP=D 


// 

JOB SFASMl 






■k 

BUILDING COMPONENT EXECUTION MODULE (S) . 

■k 





// 

LIBDEF SOURCE,SEARCH=TCPOCS.FTPS,TEMP 


// 

LIBDEF OBJ,SEARCH=TCPOCS.FTPS,TEMP 


// 

LIBDEF PHASE,SEARCH=TCPOCS.FTPS,CATALOG=TCPOCS.FTPS,TEMP 

// 

OPTION CATAL,NOXREF 


/* 





PHASE FTPSMAIN,*,NOAUTO 



INCLUDE 

SVRTVT 



INCLUDE 

FTPSMAIN 



INCLUDE 

SVRTPNS 



INCLUDE 

SVRSNAP 



INCLUDE 

SVRSCAN 



INCLUDE 

SVRNDF 



INCLUDE 

SVRCPU 



INCLUDE 

SVRIOS 



INCLUDE 

OCSSMH 



INCLUDE 

MTKMSG 



INCLUDE 

MTKCWD 



INCLUDE 

MTKPORT 



INCLUDE 

MTKRETR 



INCLUDE 

MTKSTOR 



INCLUDE 

MTKLIST 



INCLUDE 

OCSPOWER 



INCLUDE 

OCSPARSL 



INCLUDE 

MTKPWD 



INCLUDE 

MTKTYPE 



INCLUDE 

MTKSITE 



INCLUDE 

MTKDELE 



INCLUDE 

MTKHELP 



INCLUDE 

MTKUSER 



INCLUDE 

MTKPASS 



INCLUDE 

MTKQUIT 



INCLUDE 

MTKSTRU 



INCLUDE 

MTKMODE 



INCLUDE 

MTKRNFR 



INCLUDE 

MTKRNTO 



INCLUDE 

MTKNOOP 



INCLUDE 

MTKXMKD 



INCLUDE 

MTKXRMD 



INCLUDE 

MTKSTOP 



INCLUDE 

MTKTRAC 



INCLUDE 

MTKALLO 



Figure 45 (Part 1 of 2). Build the Executable Phases for OC/FTP Server 
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INCLUDE MTKCONF 
INCLUDE MIKOPER 
INCLUDE OCSLIH 
INCLUDE OCSDRH 
INCLUDE OCSIRH 
INCLUDE OCSDAH 
INCLUDE OCSPLH 
INCLUDE OCSNPL 
INCLUDE OCSVPL 
INCLUDE OCSGSV 

/* 

// EXEC PGU^ASSEMBLY 

PRINT ON, NOGEN, NODATA 

PRMOD RECFORiy^FIXUNB,CTLCHR=ASA,WORKA=YES 

END 

/* 

ENTRY FTPSMAIN 

// EXEC PGiy^LNKEDT,PARiy^<:MSHP<: 

/* 

// EXEC Pay^LIBR,PARiy^<:MSHP; ACCESS SUBLIB=TCPOCS. FTPS<: 

DELETE MTKSAM.PHASE 

/* 

PHASE SVRSAM, * 

INCLUDE SVRSAM 
INCLUDE MTKEXITS 

/* 

ENTRY SVRSAM 

/* 

// EXEC PGiy^LISIKEDT,PARiy^<:MSHP<: 

/* 

PHASE FTPSTASK,*,NOAUTO 
INCLUDE FTPSTASK 
INCLUDE OCSLIH 
INCLUDE OCSIRH 
INCLUDE OCSPLH 
INCLUDE OCSDAH 
INCLUDE OCSNPL 
INCLUDE OCSGSV 
INCLUDE OCSGEH 
INCLUDE OCSDRH 
INCLUDE OCSVPL 
INCLUDE OCSSMH 

/* 

ENTRY FTPSTASK 

/* 

// EXEC PGiy^LNKEDT,PARiy^<:MSHP<: 

/* 

/& 

* $$ EOJ 


Figure 45 (Part 2 of 2). Build the Executabte Phases for OC/FTP Server 
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6.2.4.2 Run the Site Protection Modification Job 

Figure 46 lists the job we used for the OCS license protection. The source of 
this job is obtained from PRODBLDS.PROC. 


* $$ JOB JNy^SFASM2,DISP=D,PRI=9, C 

* $$ NTFY=YES, C 

* $$ LDEST=*, C 

* $$ CLASS=0 

* _ -k 

* APPLYING LICENSE SITE PROTECTION MODIFICATION. * 

* _ 

// EXEC PGiyh=MSHP 

REMOVE 5758-PC-II5-224 APAR=SPII501 
CORRECT 5758-PC-II5-224:SPII50I IRREVOKABLE 
AFFECTS PHASE=FTPSMAIN 


ALTER 0088 /I6/AA:DA24D678DE745738CIDC60E04C5I7412 
ALTER 0000 /I6/AA:A35EF6929F756CB8496C7B334507AA27 
ALTER 0044 /I6/AA:2CC7C589EC4CC491DI90EAF899CFCDC4 
RESOLVES ^LICENSE SITE PROTECTIONS 

/* 

/& 

* $$ EOJ 


Figure 46. Site Protection Job for OC/FTP Server 


6.2.4.3 Create the FTP Server Startup Job 

The source of this job is obtained from PRODBLDS.PROC. We added the 
necessary JCL to start the program in a dynamic partition. Figure 47 lists the 
job we used. 


* $$ JOB JNM=FTPS,DISP=L,PRI=3, 

* $$ NTFY=YES, 

* $$ LDEST={,RSCS), 

* $$ CLASS=Z 

* $$ LST CLASS=A 
// JOB FTPS 

// OPTION LOG,NOSYSDUyP, JCANCEL 
// LIBDEF *,SEARCH=(TCPOCS.FTPS,PRD2.CONFIG),TEMP 
// EXEC FTPSMAIN,SIZE=(FTPSMAIN,256K) ,PARiy^SCONFIGS 
/* 

/& 

* $$ EOJ 


Figure 47. OC/FTP Server Startup Job 

This job is submitted to the POWER RDR queue and is ready to start. The 
operation and testing of OC/FTP Server are discussed in Chapter 18, “OC/FTP 
Server Operation and Examples” on page 219. 
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6.2.5 Customizing the Transiation Tabies 

This step is optionai. The OC/FTP Server comes with a default data translation 
tabie 'FTPSXLTE'. If, during the FTP session, no user specific table is specified 
via the SITE command ('QUOTE SITE XLATE newxite'), the default translation 
table will be used. 

The customization of the OC/FTP Server translation table involves three steps: 

1. Copy the sample 'FTPSXLTE' member from the OC/FTP Server production 
library. Simply issue the following command at your VSE/ICCF command 
mode screen: 

LIBRP TCPOCS.FTPS FTPSXLTE.SAMPLE FTPSXLTE 

2. Change the appropriate hexadecimal codes in the EBCDIC to ASCII table and 
vice versa. 

As an example, assume you transfer data from a PC system to VSE and you 
want to preserve the left/right bracket symbols (x'5B' and x'5D'). You need to 
change the ASCII to EBCDIC table as follows: 

The original value at x'5B' was x'4A', this means that the ASCII x'5B' left 
bracket will be translated to an EBCDIC x'4A' which is a cent sign. Since the 
EBCDIC value for the left bracket is x'80', we should change x'4A' to x'80' at 
this ASCII x'5B' location. 

Do the same for the ASCII x'5D' right bracket, and change the value from an 
EBCDIC x'4F' at that location to x'90'. 

Now if you want to have the same translation from EBCDIC to ASCII, you will 
have to modify the EBCDIC to ASCII table: 

1. Locate the EBCDIC x'80' left bracket, and change the value from an ASCII 
x'OO' at that location to x'5B'. 

2. Locate the EBCDIC x'90' left bracket, and change the value from an ASCII 
x'OO' at that location to x'5D'. 

3. Assemble and link-edit the job to produce a user specific translation phase. 
Figure 48 on page 78 lists the job we used to assemble and link-edit the 
translation table to become a new phase 'NEWXLTE'. The table has been 
customized for the preservation of the left/right brackets. 

The translation table is not part of the startup phase 'FTPSMAIN', therefore it 
is not required to rebuild this phase. 
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* $$ JOB JNiy^NEWXLTE,CLASS=A 



// JOB NEWXLTE 

- USER SPECIFIC TRANSLATION TABLE 



// LIBDEF SOURCE,SEARCH=TCPOCS.FTPS 
// LIBDEF PHASE,CATALOG=TCPOCS.FTPS 
// OPTION CATAL 

PHASE NEWXLTE, * 

// EXEC PGR^ASSEMBLY 




TITLE CTRANSLATION TABLES^ 



NEWXLTE 

CSECT 




■k 


TABLE FOR EBCDIC TO ASCII 



■k 


0I23456789ABCDEF 

EBCDIC 



DC 

X<:000I02030009007F0000000B0C0D0E0F<: 

OO-OF 



DC 

X<:I0III200000A0800I8I90000ICIDIEIF<: 

lO-IF 



DC 

X9000000000000I7IB00000000000506079 

20-2F 



DC 

X90000I6000000000400000000I4I5001AC 

30-3F 



DC 

X<:200000000000000000005B2E3C282B5D<: 

40-4F 



DC 

X9260000000000000000002I242A293B5E9 

50-5F 



DC 

XC2D2F00000000000000007C2C255F3E3F9 

60-6F 



DC 

X9000000000000000000603A2340273D229 

70-7F 



DC 

X95B6I62636465666768690000000000009 

80-8F 



DC 

X<:5D6A6B6C6D6E6F707I720000000000009 

90-9F 



DC 

X<:007E737475767778797A000000000000C 

AO-AF 



DC 

X9000000000000000000000000000000009 

BO-BF 



DC 

X<:7B4I42434445464748490000000000009 

CO-CF 



DC 

X<:7D4A4B4C4D4E4F505I520000000000009 

DO-DF 



DC 

X95C00535455565758595A0000000000009 

EO-EF 


+ 

DC 

X9303I32333435363738390000000000FF9 

FO-FF 


k 

+ 


TABLE FOR ASCII TO EBCDIC 



k 


0I23456789ABCDEF 

ASCII 



DC 

XC0001 0203372D2F,2F1 6051SOROCODOEOFC 

OO-OF 



DC 

X<:I0III2003C3D3226I8I93F27ICIDIEIFC 

lO-IF 



DC 

X9405A7F7B5B6C507D4D5D5C4E6B604B6I9 

20-2F 



DC 

XCF0FIF2F3F4F5F6F7F8F97A5E4C7E6E6F<: 

30-3F 



DC 

X<:7CCIC2C3C4C5C6C7C8C9DID2D3D4D5D6C 

40-4F 



DC 

X<:D7D8D9E2E3E4E5E6E7E8E980E0905F6D<: 

50-5F 



DC 

X9798I82838485868788899I92939495969 

60—6F 



DC 

XC979899A2A3A4A5A6A7A8A9C06AD0AI07C 

70-7F 



DC 

X9000000000000000000000000000000009 

80-8F 



DC 

X9000000000000000000000000000000009 

90-9F 



DC 

X9000000000000000000000000000000009 

AO-AF 



DC 

X9000000000000000000000000000000009 

BO-BF 



DC 

X9000000000000000000000000000000009 

CO-CF 



DC 

X9000000000000000000000000000000009 

DO-DF 



DC 

XC000000000000000000000000000000009 

EO-EF 



DC 

X9F0FIF2F3F4F5F6F7F8F9FAFBFCFDFEFFC 

FO-FF 


/* 

END 




// EXEC PGM^LNKEDT 

/4r 



/ 

/& 

* $$ EOJ 






Figure 48. Assemble and Link-edit NEWXLTE Transiation Tabie 
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6.2.6 User Exits 


There are two user exits supported by OC/FTP Server: 

1. Access Control Exit. 

This is the exit program 'FTPSXIT1' which provides some security and 
management control of the OC/FTP Server. Please refer to 6.2.3.1, “CONFIG 
Member” on page 67 for a description of the FTPSXIT1 parameter. 

2. I/O Exit. 

This exit program can provide other access methods for usage by OC/FTP 
Server. The exit is activated through the SITE command: 

quote site user ioexit exitpgm 

This defines that the exit routine exitpgm implements the access method to 
be used by the OC/FTP Server. 
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Chapter 7. OC/FTP Client Installation and Customization 


This chapter covers the installation and customization of OC/FTP Client. It 
consists of two steps: 

1. Installation - Describes the preparation and procedures to install OC/FTP 
Client in VSE/ESA 

2. Customization - Provides a detailed explanation of the product customization 


7.1 OC/FTP Client Installation 

There are two major steps involved to install the product: 

1. Prepare the installation environment for the product 

2. Install the product from tape to the VSE/ESA sublibrary 


7.1.1 Installation Preparation 

To prepare for installation of the OC/FTP Client the following definitions are 
required: 

• OCS II Gateway to VSE/ESA 

Please refer to Chapter 5, “Defining the OCS II Gateway to the Host” on 
page 41 for the setup instruetions. 

• The VSE/ESA library and sublibraries for the product installation 

Library TCPOCS definition is discussed and defined in 6.1, “OC/FTP Server 
Installation” on page 61. 

Sublibrary TCPOCS.FTPC is defined using the LIBR DEF SUB eommand in 
ICCF. This sublibrary is used to store the OC/FTP Client product, and the FTP 
client customization. 

• VSE/ESA user sublibraries for the VSE/ESA FTP elients 

This is an optional step. The numbers and names of the sublibraries to be 
used depend on the installation's requirements. You may define as many 
user sublibraries as needed. We used the sublibraries defined in 6.1, 
“OC/FTP Server Installation” on page 61. Default library and sublibrary 
assignment for the FTP clients is discussed in 7.2.4.1, “DYNALL Member” on 
page 92. 

• VSAM catalog and space definitions for the VSE/ESA FTP clients 

We used the same VSAM catalog TCPCAT defined in 6.1, “OC/FTP Server 
Installation” on page 61 for the VSE/ESA FTP clients. 

This is an optional step. You may define a new or use an existing catalog 
for the VSE/ESA FTP clients, depending on the installation's requirements. 
The default VSAM catalog assignment for the FTP elient is discussed in 
7.2.4.1, “DYNALL Member” on page 92. 
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7.1.2 Installation Procedures 

Installation of the product from tape to the product sublibrary involves the 
following steps: 

• Use the VSE/ESA II Installation dialog to generate the installation jobstreams 

• Scan the product tape by submitting the job in Figure 35 on page 63 to 
VSE/ESA 

• Submit the generated job to install OC/FTP Client into the TCPOCS.FTPC 
sublibrary 

There is no installation verification job provided by the software. You may use 
the sample job in Figure 36 on page 64, to verify that the product is recorded by 
MSFIP. Testing of the product can only be performed after the product 
customization. Please refer to Chapter 19, “OC/FTP Client Operation and 
Examples” on page 239 for the testing and operation procedures. 


7.2 OC/FTP Client Customization 

The customization is based on the samples in PRODBLDC.PROC provided by 
OC/FTP Client. After the product is installed in the product sublibrary, 
PRODBLDC.PROC is punched into an ICCF library, using the following command 
from your VSE/ICCF command mode screen: 

LIBRP TCPOCS.FTPC PRODBLDC.PROD PRODBLDC 

We then edited it into individual jobs to tailor the environment for OC/FTP Client. 

The OC/FTP Client customization consists of the following steps: 

• VSAM customization 

• VTAM customization 

• CICS customization 

• FTP client customization 

• Startup customization 


7.2.1 VSAM Customization 

When an FTP client requests a file from a TCP/IP node (via FTP GET) as VSAM 
files (ESDS, KSDS or SAM), OC/FTP Client requests VSAM to implicit-define the 
file to the assigned catalog. As discussed in 6.2.1, “VSAM Customization” on 
page 64, VSAM implicit-define requires a model in the catalog to define the data 
set. Please refer to the job in Figure 37 on page 65 for details. 

The VSAM data set definition parameters may be overridden by the DYNALL 
member and DEFAULT command. Please refer to 7.2.4.1, “DYNALL Member” on 
page 92, and Chapter 19, “OC/FTP Client Operation and Examples” on page 239 
for details. 
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7.2.2 VTAM Customization 

The following customization tasks are required in VTAM: 

• Define the logmode table and entries for the applications and LUs 

• Specify the APPL definitions for the OC/FTP Client 

• Add the LU definitions for the OCS II Gateway LUs 


7.2.2.1 Logmode Table OCSBIND 

The sample job listed in A.6, “OCSBIND MODETAB for OCS Products” on 
page 351 is used to create the OCSBIND logmode table. OC/FTP Client uses the 
following entries: 

• OCSLU62P for the OC/FTP Client program that communicates and interfaces 
with CICS via LU 6.2 sessions 

• OCSLUO for the programs used by OC/FTP Client 

• OCSLUO for the OCS II Gateway LUs used by OC/FTP Client 

Figure 49 lists the two logmode entries used by OC/FTP Client. 


(X:SLU62P MDDEENT LOGiyDDE=OCSLU62P, 

c 

TYPE=X<:00<:, 

c 

EMPR0F=XC13<:, 

c 

TSPROF=X<:07<:, 

c 

PRIPROT=X<:BO<:, 

c 

SECPROT=X<:BO<:, 

c 

CCMPROT=X<:50A1<:, 

c 

RUSIZES=X<:8585<:, 

c 

SSNDPAC=X<:07<:, 

c 

SRCVPAC=X<:07<:, 

c 

PSNDPAC=X<:07<:, 

PSERVIC=X<:060200000000000000002300<: 

c 

OCSLUO MODEENT LOGiyDDE=OCSLUO, 

c 

EMPROF=XC06<:, 

c 

TSPROF=XC03<:, 

c 

PRIPROT=X<:00<:, 

c 

SECPROT=X<:00<:, 

c 

CCMPROT=X<:0000<:, 

c 

RnST7,E.S=XCF8F8C, 

PSERVIC=X<:000000000000000000000000<: 

c 


Figure 49. MODETAB Entries for OC/FTP Client 


7 . 2 . 2.2 VTAM APPL Definitions 

Before we discuss the VTAM APPL definitions, it is important to understand how 
OC/FTP Client establishes sessions with the LUs in OCS II Gateway. 

Figure 50 on page 85 provides a summary of the OC/FTP Client sessions and 
the relationships between APPL and LU definitions. 
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VTAM, CICS and OCS II Gateway are Initialized, and OCS II Gateway Is 
connected to VTAM 

When OC/FTP Client Is started In a dynamic partition, the OC/FTP Client 
program OCSFTP62 automatically establishes the parallel sessions with ISC 
modules In the CICS partition. The number of concurrent sessions is 
determined in the OCSFTP62 APPL statement. OC/FTP Client is now ready 
to accept FTP transactions from CICS terminals 

When the FTP transaction Is entered from a CICS terminal, the OC/FTP Client 
online interface is then initialized 

When OC/FTP Client is invoked from a batch job, OC/FTP Client runs in the 
batch dynamic partition and initializes the offline interface 

After the online or offline interface is started, OC/FTP Client is ready to 
accept the OPEN command from the VSE/ESA FTP clients 

For each session request, OC/FTP Client dispatches a program with the 
name OCSFTPnn, where nn ranges from 01 to the maximum sessions 
allowed. OCSFTPnn creates an LU-LU session with the first available LU in 
OCS II Gateway 

OCSFTPnn Is a VTAM application and must be defined In the VTAM APPL 
major node. The number of OCSFTPnn APPL entries depends on the 
maximum number of concurrent FTP sessions required 

After the OCSFTPnn application establishes an LU-LU session with the OCS 
II Gateway LU, the system Is ready for FTP requests such as PUT and GET 
from the VSE/ESA FTP clients 




Figure 50. OC/FTP Client Applications and LU Relationships 


The VTAM APPL entries for OC/FTP Client are listed in Figure 51 on page 86. 
The completed VTAM APPL major node definition is listed in A.4, “VTAM APPL 
Major Node for OCS Products” on page 344. 
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CICSSA22 APPL 


OCSFTP62 APPL 

OCSFTPOl APPL 
OCSFTP02 APPL 
OCSFTP03 APPL 
OCSFTP04 APPL 
OCSFTP05 APPL 
OCSFTP06 APPL 
OCSFTP07 APPL 
OCSFTP08 APPL 
OCSFTP09 APPL 
OCSFTPIO APPL 


AUTH= (PASS,ACQ,VPACE),PARSESS=YES,ACBNAyE=CICSSA22, C 

EAS=4000,iyDDETA&CICSIPMr,APPC=NO, C 

SONSCIP=YES,VPACING=5 

iyDDETAB=OCSBIND, DLOGiyDD=OCSLU62P, AUTH= (ACQ), APPC=YES, C 
PARSESS=YES, DSESLEM^IO, DMIMaIN]j=0, DMIMaINR= 10 
iyDDETAB=OCSBIND, DLOGiyDD=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=QCSBIND, DLQGiyDD=QCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=OCSBIND, DLQGiyDD=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=OCSBIND, DLQGiyDD=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=OCSBIND, DLQGiyDD=QCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=QCSBIND, DLQGiyDD=QCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=OCSBIND, DLQGiyDD=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=OCSBIND, DLQGiyDD=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=QCSBIND, DLQGiyDD=QCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
iyDDETAB=QCSBIND, DLQGiyDD=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 


Figure 51. VTAM APPL Statements for OC/FTP Client 


The key definitions and parameters are: 

• PARSESS=YES in the CICS APPL statement. This parameter aiiows CICS to 
have paraiiei sessions with the OC/FTP Client application OCSFTP62. Details 
of the CICS parallel session definitions are discussed in 7.2.3, “CICS 
Customization” on page 88. 

• APPL statement for OCSFTP62. The definition is based on the sample from 
PRODBLDC.PROC. This program is responsible to set up multiple sessions 
and to interface with CICS. The key parameters are: 

- MODETAB and DLOGMOD. Identify the appropriate logmode table entry. 

- ACQ in AUTH parameter. Allows OCSFPT62 to acquire LUs. 

- APPC. Allows OCSFTP62 to participate in LU 6.2 sessions with CICS. 

- PARSESS. Allows OCSFTP62 to have parallel sessions with CICS. 

- DSESLIM. Defines the maximum number of sessions between this 
application and CICS. This parameter is one of the factors governing the 
maximum number of online FTP clients 

- DMINWNL and DMINWNR. Determine that CICS is the contention winner 
for the parallel sessions. 

• APPL statements for OCSFTPnn. Another factor governing the maximum 
number of online FTP clients, is the number of OCSFTPnn APPL statements, 
nn consists of values ranging from 01 to the maximum number of online FTP 
clients required. 

You should define as many OCSFTPnn APPL statements as needed. The 
number of OCSFTPnn APPL statements should match the values specified in 
the DSESLIM parameter of the OCSFTP62 APPL statement. The names of 
the APPL statements must also match the entries in 7.2.4.2, “FAPPL 
Member” on page 94. 

The key parameters are: 

- MODETAB and DLOGMOD. Identify the appropriate logmode table entry. 

- NVPACE in AUTH parameter. Turns off pacing for FTP. 

- ACQ in AUTH parameter. Allows this application to acquire LU in OCS II 
Gateway. 
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EAS = 2. Allows two concurrent sessions for this application. 


7.2.2.3 VTAM LU Definition 

The completed OCS II Gateway LU definitions are listed in Figure 24 on page 47, 
and A.3, “VSE TCPSW.B Switched Major Node” on page 342. 

Figure 52 lists the LU definitions used by OC/FTP Client. We defined seven LUs 
for the online FTP clients. The number of LUs depends on the installation 
requirements. 


IPFT2S9B LU 

LOCADDR=2, DLOGiyDD=(XSLUO, 

C 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VIiyMDL, MDLENT=VSELU2A, 

SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 

c 

IPFT2S9C LU 

LOCADDR=3, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VIiyMDL, MDLENT=VSELU2A, 

SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 

c 

IPFT2S9D LU 

LOCADDR=4, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VIiyMDL, MDLEISIT=VSELU2A, 

SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 

c 

IPFT2S9E LU 

LOCADDR=5, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VIiyMDL, MDLENT=VSELU2A, 

SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 

c 

IPFT2S9F LU 

LOCADDR=6, DLOGiyDD=(XSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VIiyMDL, MDLEIS1T=VSELU2A, 

SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 

c 

IPFT2S9G LU 

LOCADDR=7, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VIiyMDL, MDLENT=VSELU2A, 

SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 

c 

IPFT2S9H LU 

LOCADDR=8, DLOGiyDD=(XSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VIiyMDL, MDLENT=VSELU2A, 

SSCPFiyF=USSSCS, USSTAB=VIMUSSTR 

c 


Figure 52. Logical Unit Definitions for OC/FTP Client 


The key parameters are: 

• The LU name. Must match the: 

- LU name in the OCS II Gateway customization 

- LU name in the Network LU List Member(s). Please refer to 7.2.4.4, 
“NETWORKS LU List Member for IPFNET NETWORKS Member” on 
page 97, 7.2.4.5, “NETWORKS LU List Member for SUNNET NETWORKS 
Member” on page 97 and 7.2.4.4, “NETWORKS LU List Member for 
IPFNET NETWORKS Member” on page 97 for the explanation of Network 
LU List members. 

• LOCADDR. Must match the LU number in the OCS II Gateway customization. 

• MODETAB and DLOGMOD. Identify the appropriate logmode table entry. 
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7.2.3 CICS Customization 

This section covers the definitions in CICS to enabie VSE/ESA users to use 
OC/FTP Client oniine. Our definition is based on the sampies in 
PRODBLDC.PROC provided by OC/FTP Ciient. We used the CEDA transaction to 
define the foiiowing resources to CiCS: 

• Connection VSE 

• Session VSESESS 

• Transaction FTP 

• Program APPCFTPC 

We fiied these resources under the group VSEGROUP. After the resources are 
defined, we used: 

• CEDA INSTALL GROUP(VSEGROUP) to activate VSEGROUP 

• CEDA ADD GROUP(VSEGROUP) to make VSEGROUP permanent 

Screen images of the CEDA sessions are reproduced in this section, to heip you 
with the definitions in your instailation. 


7.2.3.1 Connection VSE 

A connection is used to define a VTAM appiication communicating with CICS 
through ISC or MRO. 

As illustrated in Figure 50 on page 85, OC/FTP Ciient appiication OCSFTP62 
communicates with CICS via the ISC links. OCSFTP62 is defined to CICS using 
CEDA DEF CONN with the connection name VSE. Listed below are the 
specifications of the VSE connection. 


CEDA DEFINE 
Connection : VSE 

Group : VSEGROUP 

CONNECTION IDENTIFIERS 
Netname : OCSFTP62 

INDsys : 

REMOTE ATTRIBUTES 
REMOTESystem : 

REMDTEName : 

CONNECTION PROPERTIES 
ACcessmethod : Vtam 

Protocol : Appc 

SInglesess : No 

Datastream : User 

RECordformat : U 

OPERATIONAL PROPERTIES 
AUtoconnect : All 

INService : Yes 

SECURITY 
SEcurityname : 

ATtachsec : Local 

Bindpassword : 


Vtam I IRc I INdirect 
Appc I Lu61 
No I Yes 

User I 3270 I SCs I STrfield | Lms 
U I Vb 

No I Yes I All 
Yes I No 


Local I Identify I Verify 
PASSWORD NOT SPECIFIED 
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The key parameters are: 

• CONNECTION. The name of the connection. It must match the 
CONNECTION name in the session definition. 

• GROUP. The name of the group to which this definition beiongs. 

• NETNAME. The VTAM APPLID of the OC/FTP Ciient appiication OCSFTP62. 
Piease refer to Figure 51 on page 86 for the OCSFTP62 APPL statement. 

• ACCESSMETHOD. VTAM as the access method. 

• PROTOCOL. APPC to be used for CICS ISC. 

7.2.3.2 Session VSESESS 

A session is used to define the iogicai iinks and the session characteristics 
between CiCS and OCSFTP62. The session definitions are cioseiy reiated to the 
APPL statement of OCSFTP62. Listed beiow are the specifications of the 
VSESESS session. 


CEDA DEFINE 


Sessions 

VSESESS 


Group 

VSEGROUP 


SESSION IDENTIFIERS 


Connection 

VSE 


SESSName 

NETnameq 

NDdename 

OCSLU62P 


SESSION PROPERTIES 


Protocol 

Appc 

Appc 1 Lu61 

MAximum 

00010 , 00010 

0-32767 

RECEIVEPfx 

RECEIVECount 

No 

No 1 1-999 

SENDPfx 

SENDCount 

No 

No 1 1-999 

SENDSize 

04096 

1-30720 

RECEIVESize 

04096 

1-30720 

OPERATOR DEFAULTS 


OPERId 

OPERPriority 

000 

0-255 

OPERRsl 

0 


OPERSecurity 

1 


USERId 

SESSION USAGES 

Transaction 

SESSPriority 

000 

0-255 

OPERATIONAL PROPERTIES 


Autoconnect 

All 

No 1 Yes 1 All 

INservice 


No 1 Yes 

Buildchain 

Yes 

Yes 1 No 

USERArealen 

000 

0-255 

lOarealen 

00000 , 00000 

0-32767 

RELreq 

No 

No 1 Yes 

Discreq 

No 

No Yes 

NEPclass 

000 

0-255 

RECOVERY 

RECOvoption 

: Sysdefault 

Sysdefault | None 


The key parameters are: 
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• SESSION. The name of the session. 

• GROUP. The name of the group to which this definition beiongs. 

• CONNECTION. The name of the connection associated with this session, it 
must match the connection name defined in the CONNECTION definition. 

• MODENAME. The logmode entry for OCSFTP62. It must match the 
DLOGMOD value of the OCSFTP62 APPL statement. 

• PROTOCOL. APPC is required for ISC. 

• MAXIMUM. This parameter has two values. The first value defines the 
maximum number of sessions supported. It should match the DSESLIM 
parameter of the OCSFTP62 APPL statement. The second value defines the 
maximum number of sessions as contention winner. It should match the 
DMINWNR parameter of the OCSFTP62 APPL statement. 

• SENDSIZE. The RU size for send. 

• RECEIVESIZE. The RU size for receive. 

• AUTOCONNECT ALL. Automatic session connection between CICS and 
session partner OCSFTP62 during CICS initialization. 


7.2.3.3 Define the "FTP" Transaction 

CEDA DEF TRAN(FTP) is used to define the OC/FTP Client transaction FTP to 
CICS. Listed below are the specifications of the FTP transaction. 
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CEDA DEFINE 


TRansaction 

FTP 



Group 

VSEGROUP 



PROGram 

APPCFTPC 



TWasize 

00256 

0-32767 


PROFile 

PArtitionset 

DFHCICST 



STatus 

Enabled 

Enabled | 

Disabled 

PRIMedsize 

00000 

0-65520 


REMOTE ATTRIBUTES 



DYnamic 

No 

No 1 Yes 


REMOTESystem 

REMOTEName 

TRProf 

Localq 


No 1 Yes 


SCHEDULING 




PRIOrity 

001 

0-255 


TClass 

No 

No 1 1-10 


ALIASES 




Alias 

TAskreq 

Xtranid 




RECOVERY 




DTimout 

No 

No 1 1-7000 

Indoubt 

Backout 

Backout 1 

Commit I Wait 

REStart 

No 

No 1 Yes 


SPurge 

No 

No 1 Yes 


TPurge 

No 

No 1 Yes 


DUnp 

Yes 

Yes 1 No 


TRACe 

SECURITY 

Yes 

Yes 1 No 


Extsec 

No 

No 1 Yes 


TRANsec 

01 

1-64 


RSL 

Public 

0-24 1 Public 

RSLC 

No 

No 1 Yes 

External 


The key parameters are: 

• TRANSACTION. The name of the OC/FTP Client transaction. 

• GROUP. The name of the group to which this definition belongs. 

• PROGRAM. The first CICS program that this transaction invokes. 

• TWASIZE. The transaction work area. 256 bytes is recommended by OCS. 

7.2.3.4 Program APPCFTPC 

CEDA DEF PRO(APPCFTPC) is used to define the OC/FTP Client program 
APPCFTPC to CICS. Listed below are the specifications of the APPCFTPC 
program. 
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CEDA DEFINE 


PRCGram 

: APPCFTPC 

Group 

: VSEGROUP 

Language 

: Asseirbler 

RELoad 

: No 

RESident 

: No 

RSI 

: 00 

Status 

: Enabled 


REMOTE ATTRIBUTES 
REMOTESystem : 
REMOTEName : 

Transid : 

Executionset : Fullapi 


CObol I Assembler | C | Pli | Rpg 

No I Yes 

No I Yes 

0-24 I Public 

Enabled | Disabled 


Fullapi I Dplsubset 


The key parameters are: 

• PROGRAM. The name of the program associated with transaction FTP. 

• GROUP. The name of the group to which this definition beiongs. 

• LANGUAGE. The programming ianguage of this program is ASSEMBLER. 


7.2.4 FTP Client Customization 

This section covers the definitions required by the FTP function of OC/FTP Ciient. 
The foiiowing members are discussed: 

• DYNALL. Defines the defauit VSAM and LIBR environments for the VSE/ESA 
FTP ciients. 

• FAPPL. Defines the programs used by OC/FTP Ciient. 

• NETWORKS. Defines IP network names and addresses. 

• NETWORKS LU List "IPFNET'. Aiiocates LUs to the networks defined in the 
NETWORKS member. 

• HOSTS. Defines TCP/IP IP addresses and host names. 

• CACHE. Defines the most commoniy used IP addresses. 

• PACING. Defines the FTP inbound and outbound pacing vaiues. 

• NETMASK. Defines the IP subnet mask. 

• RESOLVER. Defines the IP domain name server. 

AM these members are fiied in subiibrary TCPOCS.FTPC. 

7.2.4.1 DYNALL Member 

The DYNALL member is used to define the defauit VSAM and VSE/ESA library 
environments for the VSE/ESA FTP ciients. 

The defauit vaiues provided by OC/FTP Ciient may not appiy to your instailation. 
You shouid review and taiior the sampie specifications provided in 
PRODBLDC.PROC. 
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The specification in the DYNALL member can be overridden by the DEFAULTS 
command. Piease refer to the description of the DEFAULT command in 
Chapter 19, “OC/FTP Ciient Operation and Exampies” on page 239 for detaiis. 





Figure 53 on page 93 lists the default environment we tailored. 


* $$ JOB JNiyNCFDYNALL,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB CFDYNALL 


// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS 

.FTPC 

CATALOG DYNALL.FTP EOD=$$ REPLACE=Y 

VSAMCAT 

TCPCAT 

DEFAULT VSAM CATALOG 

LRECL 

00132 

DEFAULT LIBR/VSAM RECORD LENGTH 

PALLOC 

0000512 

DEFAULT VSAM PRIMARY ALLOCATION 

SALLOC 

0000256 

DEFAULT VSAM SECONDY ALLOCATION 

CISIZE 

04096 

DEFAULT VSAM DATA CISIZE 

CISIZEDATA 

02048 

ALTERNATE DATA CISIZE KEYWORD 

BUFND 

020 

DEFAULT VSAM DATA BUFND= 

BUFNDATA 

010 

ALTERNATE DATA BUFND= KEYWORD 

BUFSP 

0000000 

DEFAULT VSAM CLUSTER BUFSP= 

OPNDSP 

NEW 

DEFAULT VSAM OPEN DISPOSITION 

CLSDSP 

KEEP 

DEFAULT VSAM CLOSE DISPOSITION 

RETAIN 

0007 

DEFAULT VSAM CLUSTER RETENTION 

MODE 

LIBR 

DEFAULT OPERATION MODE 

DDSN 

CCS.FTP. 

TESTING DEFAULT VSAM DATASET NAME 

DLIB 

TCPOCS 

DEFAULT LIBRARIAN LIBRARY 

DSLIB 

USRl 

DEFAULT LIBRARIAN SUBLIBRARY 

DMBRN 

FTPOBJ 

DEFAULT LIBRARIAN MEMBER NAME 

DMBRT 

TCP IP 

DEFAULT LIBRARIAN MEMBER TYPE 

RECEM 

RECORD 

DEFAULT LIBR/VSAM RECORD FORMAT 

BUFNINDEX 

004 

DEFAULT VSAM KSDS BUFNI= 

BLKFACTOR 

001 

DEFAULT VSAM BLOCK FACTOR 

KEYLOCATION 

000 

DEFAULT VSAM KSDS KEY LOCATION 

KEYLENGTH 

010 

DEFAULT VSAM KSDS KEY LENGTH 

CAFREESPACE 

000 

DEFAULT VSAM KSDS CA FREESPACE 

CIFREESPACE 

000 

DEFAULT VSAM KSDS Cl FREESPACE 

CISIZEINDEX 

000 

DEFAULT VSAM KSDS CISIZE 

MODET .ENTRY 

NULL 

DEFAULT VSAM MODEL ENTRY 

SHARE 

2 

DEFAULT VSAM SHAREOPTION 

UNITS 

$$ 

/* 

/& 

* $$ EOJ 

REC 

DEFAULT VSAM ALLOCATIONS UNITS 


Figure 53. DYNALL Member for OC/FTP Client 
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Listed below is a brief description of the parameters: 

• VSAMCAT. The default VSAM master/user catalog DLBL name used for 
VSAM file transfer. This will be used when no CWD specified via VSECD 
command. 

• LRECL. The maximum VSAM logical record length. 

• PALLOC. The primary record allocation for the VSAM implicit-define. The 
value is changed from 256 to 512 records. 

• SALLOC. The secondary record allocation for the VSAM implicit-define. The 
default is 256. 

• CISIZE. The VSAM Cl size. We specified a 4K Cl size. 

• BUFND. The number of Cl buffers to be allocated. We specified 20 Cl buffers. 

• BUFSP. The buffer space to be allocated. We let it default to 0. 

• OPNDSP and CLSDSP. The open and close dispositions of the data set. 

• RETAIN. The number of retention days of the data set. The default value is 7. 

• MODE. The access mode for the VSE/ESA FTP clients. The value can be 
VSAM or LIBR. 

• DDSN. The default VSAM file node name to be searched in the working 
directory, if not specified in the MPUT command. A value of marks all the 
files in the working directory. 

This parameter is especially important for the MPUT command. If the FTP 
clients want to put multiple VSAM files with the same file node name to the 
TCP/IP FTP server, the node name should be specified in the: 

- DDSN parameter of the DYNALL member or 

- DSN parameter of the DEFAULTS command 

For example, If you want to PUT the following files to the FTP server: 

- TEST.FILE1 

- TEST.FILE2 

- TEST.FILE3 

You should override the DSN with the node name 'TEST using the 
DEFAULTS command, then issue the 'MPUT *' command to put all three files 
to the FTP server. 

• DLIB and DSLIB. The names of the default library and sublibrary. 

• DMBRN and DMBRT. The default member name and type. 

7.2.4.2 FAPPL Member 

The FAPPL member is used to define the VTAM ACB names used by OC/FTP 
Client. The names must match the OCSFTPnn APPL entries defined in the VTAM 
APPL major node. 

Figure 54 on page 95 lists the job we used. 
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* $$ JOB JNiyNCFAPPLS,DISP=D,PRI=3,NTEY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB CSAPPLS 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG FAPPLS.FTP EOD=$$ REPLACE=Y 
OCSFTPOl 
OCSFTP02 
OCSFTP03 
OCSFTP04 
OCSFTP05 
OCSFTP06 
OCSFTP07 
OCSFTP08 
OCSFTP09 
OCSFTPIO 
$$ 

/* 

/& 

* $$ EOJ 


Figure 54. FAPPL Member for OC/FTP Client 


7.2.4.3 NETWORKS Member 

The NETWORKS and NETWORK LU List members are used to define to OC/FTP 
Client, the: 

• IP network names and addresses 

• OCS II Gateway LU assignments to specific networks 

The 32-bit IP address consists of the network address and host address. It is 
usually represented in a four-part dotted decimal format, for example 
192.61.100.81. 

The length of the network and host address Is determined by the IP address 
class used. There are four IP address classes: A, B, C and D. Please refer to 
TCP/IP Tutorial and Technical Overview, GG24-3376 for the description of IP 
addresses and classes. 

We used both IP address class C and class A in our TCP/IP network. 

For IP address class C, we use a subnet mask 255.255.255.0. This means there 
are 8 bits left for host addresses and we don't have a subnetwork. As usual, bits 
1-3 of the IP address are the IP address class Identifier. The next 21 bits are the 
network address, followed by 8 bits for the host address. In dotted decimal 
format, the first three parts form the network address and the last part forms the 
host address. 

For IP address class A, we also use a subnet mask 255.255.255.0. Since class A 
only uses the first 8 bits for the network address, the next 16 bits are used for 
subnetworking, followed by the last 8 bits for host addresses. For this case, we 
have to specify a subnet mask in the NETMASK member. Please refer to 7.2.4.10, 
“NETMASK Member” on page 101. In dotted decimal format, the first part 
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identifies the network address, the second and third parts form a subnetwork 
address, and the iast part forms the host address. 

Aii these IP addresses and subnet masks wili oniy be used by the appiications to 
determine the route to nodes within the TCP/IP network. The IP address class 
only limits the number of hosts in the network and the subnet mask only divides 
the existing network into two or more smaller networks allowing for more hosts 
to be attached. 

Figure 55 illustrates the definitions and relationships between the NETWORKS 
and NETWORK LU List members for our configuration. 


NETWORKS.FTP 


IPFNET 

192.61.100 

SUNNET 

192.61.200 

AIXNET 

9.164.182 


IPFNET.FTP 


LU 

IPFT2S9B 

AIXNET.FTP 

SUNNET.FTP 

LU 

IPFT2S9C 



LU 

IPFT2S9D 

LU IPFT2S9F 

LU IPFT2S9H 

LU 

IPFT2S9E 

LU IPFT2S9G 



OCS II GATEWAY 


PU 

IPFP2209 

LU 

IPFT2S9B 

LU 

IPFT2S9C 

LU 

IPFT2S9D 

LU 

IPFT2S9E 

LU 

IPFT2S9F 

LU 

IPFT2S9G 

LU 

IPFT2S9H 


Figure 55. Definition and Relationships between NETWORKS and LU List Members 

This definition is based on the network diagram in Figure 13 on page 34, and the 
IP address and name assignments in Table 3 on page 36. In the NETWORKS 
Member, we defined three networks with IPFNET as the default network: 

• IPFNET with IP network address 192.61.100 (IBM Token-Ring LAN) 

• SUNNET with IP network address 192.61.200 (Ethernet LAN) 

• AIXNET with IP network address 9.164.182 (IBM Token-Ring LAN) 

Figure 56 on page 97 shows the job we tailored. 
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* $$ JOB JNiyN0FNETW,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB CFNETW 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG NETWORKS.FTP EOD=$S REPLACE=Y 
IPFNET 192.61.100 
SUNNET 192.61.200 
AIXNET 9.164.182 
IPFNET 
$$ 

/* 

/& 

* $$ EOJ 


Figure 56. NETWORKS Member for OC/FTP Client 


7.2.4.4 NETWORKS LU List Member for IPFNET NETWORKS 
Member 

We used the IPFNET.FTP member to assign four LUs to the IPFNET network. The 
LU list member name must correspond to the network name defined In the 
NETWORKS member. The LU names must correspond to the LU names defined 
for OCS II Gateway. 

Figure 57 lists the job we tailored. 


* $$ JOB JNiyKT’LUVSE,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS=A 
// JOB CFLUVSE 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG IPFNET.FTP EOD=$$ REPLACE=Y 
GATEWAY BEGIN 
LU IPFT2S9B 
LU IPFT2S9C 
LU IPFT2S9D 
LU IPFT2S9E 
GATEWAY END 
$$ 

/* 

/& 

* $$ EOJ 


Figure 57. NETWORK LU List Member for iPFNET NETWORKS Member 


7.2.4.5 NETWORKS LU List Member for SUNNET NETWORKS 
Member 

We used the SUNNET.FTP member to assign two LUs to the SUNNET network. 
The LU list member name must correspond to the network name defined in the 
NETWORKS member. The LU names must correspond to the LU names defined 
for OCS II Gateway. 
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Figure 58 on page 98 lists the job we tailored. 


* $$ JOB JNiyKI’LUVSE2,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB CFLUVSE2 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG SONNET.FTP EOD=$$ REPLACE=Y 
GATEWAY BEGIN 
LU IPFT2S9H 
GATEWAY END 
$$ 

/* 

/& 

* $$ EOJ 


Figure 58. NETWORK LU List Member for SUNNET NETWORKS Member 


7.2.4.6 NETWORKS LU List Member for AIXNET NETWORKS 
Member 

We used the AIXNET.FTP member to assign two LUs to the AIXNET network 
which Is a class A network and needs a subnet mask Identification from the 
NETMASK member. The LU list member name must correspond to the network 
name defined in the NETWORKS member. The LU names must correspond to 
the LU names defined for OCS II Gateway. 

Figure 59 lists the job we tailored. 


* $$ JOB JNiyNCFLUVSE3,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS=A 
// JOB CFLUVSE3 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG AIXNET.FTP EOD=$$ REPLACE=Y 
GATEWAY BEGIN 
LU IPFT2S9F 
LU IPFT2S9G 
GATEWAY END 
$$ 

/* 

/& 

* $$ EOJ 


Figure 59. NETWORK LU List Member for AtXNET NETWORKS Member 
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7.2.4.7 HOSTS Member 

This member is used to define the local and remote IP addresses and host 
names to OC/FTP Client. With the specifications in this member, the VSE/ESA 
FTP clients may use the host name for the OPEN command. The definitions in 
this member are based on the IP name and address assignments In Table 3 on 
page 36. 

Figure 60 lists the job we tailored. 


* $$ JOB JNM=CFHOSTS,DISP=D,PRI=3,NIFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS= 

=A 

// JOB CFHOSTS 


// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG HOSTS.FTP EOD=S$ REPLACE=Y 

192.61.100.84 

TCPCL2 

192.61.100.55 

RS6TECTR 

192.61.200.55 

RS6 

192.61.200.91 

SUN2 

9.164.182.132 

AIX560 

$$ 


/* 


/& 


* $$ EOJ 



Figure 60. HOSTS Member for OC/FTP Client 


— Note - 

There are no host names AIX320, TCPCL1 and TCPCL3. These three hosts 
are using the domain name system. They go through the domain name 
server TCPCL1 to resolve unknown host names. Please refer to 
7.2.4.11, “RESOLVER Member” on page 101 for more Information on domain 
name server. 


7.2.4.8 CACHE Member 

This member is used to define the most commonly used IP addresses to the 
OC/FTP Client. They are usually the IP addresses defined In the HOSTS 
member. These IP addresses will be loaded Into memory when the OC/FTP 
Client Is started. This saves time searching for the IP addresses. 

Figure 61 on page 100 lists the job we tailored. 


Chapter 7. OC/FTP Client Installation and Customization 99 





* $$ JOB JNiyNCFCACHE,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB CFCACHE 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG CACHE.FTP EOD=S$ REPLACE=Y 
192.61.100.84 
$$ 

/* 

/& 

* $$ EOJ 


Figure 61. CACHE Member for OC/FTP Client 


7.2.4.9 PACING Member 

This member is used to define the OCS appiication ievei pacing vaiues between 
OC/FTP Ciient and the remote node. Piease refer to the PACEiN/PACEOUT 
parameter in 6.2.3.1, “CONFIG Member” on page 67, for an explanation of OCS 
pacing. 

You may include as many statements as required to define the OCS pacing 
values between OC/FTP Client and the remote nodes. The definition statement 
consists of three fields: 

1. The first field is the inbound pacing 

It defines the number of RUs the remote FTP server may send to OC/FTP 
Client, before waiting for a pacing response from OC/FTP Client 

2. The second field is the outbound pacing 

It defines the number of RUs OC/FTP Client may send to the remote FTP 
server, before waiting for a pacing response from the remote server 

3. The third field defines the name of the remote FTP server 
Figure 62 lists the job we tailored. 


* $$ JOB JNiyNCFPACING,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS=A 
// JOB CFPACING 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUBLIB=TCPOCS.FTPC 

CATALOG PACING.FTP EOD=$$ REPLACE=Y 

10.10 TCPCLl 

10.10 TCPCL2 

10.10 TCPCL3 

10.10 AIX320 

10.10 AIX560 
$$ 

/* 

/& 

* $$ EOJ 


Figure 62. PACING Member for OC/FTP Client 
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7.2.4.10 NETMASK Member 

Since we have a Token-Ring network 9.164.182 which has subnetworking, we 
have to define our subnet mask in this member. 

This member is used oniy to specify the subnet masks for the impiementation of 
IP subnets. Those networks which do not use subnetworking don't have to be 
specified here. Piease refer to TCP/IP Tutorial and Technical Overview, 
GG24-3376 tor the expianation of iP subnets. Figure 63 lists the job we taiiored. 


* $$ JOB JNM=NETMASK, CLASS=A, DISP=D 
// JOB NETMASK - FOR SUBNET MASK 

// EXEC LTBR,PARiy^<:MSHP<: 

ACC S=TCPOCS.FTPC 

CATATXXT NETMASK.FTP EOD=$$ REPTACE=Y 
9.T64.T82 255.255.255.0 
$$ 

/* 

/& 

* $$ EOJ 


Figure 63. NETMASK Member for OC/FTP Client 


7.2.4.11 RESOLVER Member 

In our test environment, we have set up the OS/2 TCP/iP (TCPCL1) to be a 
domain name server for the foiiowing hosts: 

• OS/2 itseif named TCPCL1 

• PC/DOS Windows named TCPCL3 

• RiSC/6000-320 OCS il named AIX320 

These hosts don't have a hosts fiie in their /etc directory. They resoive host 
names through the Domain Name Server (DNS) TCPCL1.ITSC.IBM.COM. 

In the first piace, these hosts wili iook into /etc directory to see if a resoiver fiie 
exists. If it does and the domain name server is running, the host name is 
resolved through DNS. If the DNS cannot resolve the host name, then the host's 
file is searched, if it exists. 

In contrast, our VSE/ESA host will search its host's file (HOSTS member) first. If 
the name is not found and the RESOLVER member exists, it will resolve the host 
name through the DNS. 

We have cataloged this member into the product sublibrary TCPOCS.FTPC. 

// LIBDEF *,SEARCH=TCPOCS.FTPC 

Please refer to 7.2.5.3, “Create the FTP Client Startup Online Jeb” on page 104 
for the OC/FTP Client startup job. Refer alse te 19.2.1, “Get a File from PC/DOS 
to VSE Library” on page 245 for an example of resolving host names via a 
Demain Name Server. Figure 64 on page 102 lists the job we tailored. 
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* $$ JOB JM^RESOLVER, CIASS=A, DISP=D 

// JOB RESOLVER - FOR DOMAIN NAME RESOLVER 
// EXEC LIBR,PARiy^<:MSHP<: 

ACC S=TCPOCS.FTPC 

CATALOG RESOLVER.FTP EOD=$$ REPLACE=Y 
DFNAME ITSC.IBM.CCM 

SERVER 192.61.100.83 TCPCLl.ITSC.IHM.CCM 
$$ 

/* 

/& 

* $$ EOJ 


Figure 64. RESOLVER Member for OC/FTP Client 


7.2.5 Startup Customization 

The following preparation tasks are required to bring up OC/FTP Client: 

• Build the executable phases 

• Run the site protection modification job 

• Create the FTP Client startup job 

• Create the sample FTP client batch job 


7.2.5.1 Build the Executable Phase 

Figure 65 on page 103 lists the job we used to assemble and lInk-edIt the 
OC/FTP Client phase Into the TCPOCS.FTPC subllbrary. The source of this job Is 
provided in PRODBLDC.PROC. 

- Note - 

We put OCSSMH into the member shipped. 
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* $$ JOB JNyN3’ASM,CLASS=0,DISP=D,NTFY=YES 
// JOB CFASM 

★ -k 

* BUILDING COMPONENT EXECUTION MODULE (S) . * 

★ k 

// OPTION CATAL,NOXREF 

// LIBDEF OBJ,SEARCH=TCPOCS.FTPC,TEMP 

// LIBDEF SOURCE,SEARCH=TCPOCS.FTPC,TEMP 


// LIBDEF PHASE,SEARCH=TCPOCS.FTPC,CATALOG=TCPOCS.FTPC,TEMP 
PHASE FTPC,*, NOAUTO 
INCLUDE CLNTVT 
INCLUDE OCSCVT 
INCLUDE MTKFTPM 
INCLUDE OCSDAH 
INCLUDE OCSIRH 
INCLUDE OCSPLH 
INCLUDE OCSDRH 
INCLUDE OCSLIH 
INCLUDE OCSGEH 
INCLUDE OCSDTF 
INCLUDE MTKINIT 
INCLUDE MTKLOGON 
INCLUDE OCSNPL 
INCLUDE NDFSIH 
INCLUDE OCSVPL 
INCLUDE MTKTIO 
INCLUDE MTKPORTX 
INCLUDE MTKFTPW 
INCLUDE MTKXLATE 
INCLUDE OCSDMH 
INCLUDE MTKTIME 
INCLUDE CLNTRNS 
INCLUDE CLNSCAN 
INCLUDE CLNSAM 
INCLUDE CLNNDF 
INCLUDE CLNIOS 
INCLUDE CLNCPU 
INCLUDE OCSSMH 
INCLUDE MTKRESV 
INCLUDE OCSMLH 
INCLUDE MTKEXITl 
INCLUDE OCSGSV 
INCLUDE 

/* 

// EXEC PGM^ASSEMBLY 
PRINT ON, NOGEN, NODATA 

CDMOD RECFORMP=FIXUNB,WORKA=YES,TYPEFLE=INPUT 

PRMOD RECFORiyp=FIXUNB,WORKA=YES 

END 

/* 

ENTRY OCSIOO 

// EXEC PGiy^LNKEDT,PARiy^<:MSHP<: 

/* 

/& 

* $$ EOJ 

Figure 65. Build the Executable Phases for OC/FTP Client 
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7.2.5.2 Run the Site Protection Modification Job 

Figure 66 lists the job we used for the OCS license protection. The source of 
this job is provided in PRODBLDC.PROC. 


* $$ JOB JNiyN0FASM2,CLASS=0,DISP=D,NTFY=YES 
// JOB CFASM2 

* -k 

* APPLYING LICENSE SITE PROTECTION MODIFICATION. * 

* k 

// EXEC PGiyh=MSHP 

REMOVE 5758-PC-0I4-224 APAR=SP0I401 
CORRECT 5758-PC-0I4-224:SP0I40I IRREVOKABLE 
AFFECTS PHASE=FTPC 

ALTER OOOC /I6/AA:DCE4I639II7EB548EFD06F750D973I6I 
ALTER OOIC /I6/AA:A30366608A74I3E8BE67747583F0B5B4 
ALTER 002C /I6/AA:2CC7C589EC4CC491DI90EAF899CFCDC4 
RESOLVES ^LICENSE SITE PROTECTIONC 

/* 

/& 

* $$ EOJ 


Figure 66. Site Protection Job for OC/FTP Ciient 


7.2.5.3 Create the FTP Client Startup Online Job 

The source of this job is provided in PRODBLDC.PROC. We added the 
necessary JCL to start OC/FTP Client in a dynamic partition. 

Figure 67 lists the job we used. 


* $$ JOB JN]yh=FTPC,DISP=L,PRI=3,NTFY=YES,LDEST=*,CLASS=Y 
// JOB FTPC 

k 

// LIBDEF *,SEARCH=TCPOCS.FTPC,TEMP 
// EXEC PGiyKX:SFTPC,SIZE=(OCSFTPC,256K) 

/* 

/& 

* $$ EOJ 


Figure 67. OC/FTP Ciient Startup Job 

This job is submitted to the POWER RDR queue and is ready to start. The 
operation and testing of OC/FTP Client are discussed in Chapter 19, “OC/FTP 
Client Operation and Examples” on page 239. 
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7.2.5.4 Create the Sample FTP Client Batch Job 

The sample FTP client job In PRODBLDC.PROC may be customized, to start and 
execute OC/FTP Client In a batch partition. Figure 68 lists the job we tailored to 
test out various FTP functions. 


* $$ JOB JNiyN3mTCH,DISP=L,PRI=3,NIFY=YES,LDEST=*,CLASS=Y 
// JOB CFBATCH 

■k 

// LIBDEF *,SEARCH=TCPOCS.FTPC,TEMP 
// EXEC PGiyh=FTPC, SIZE= (FTPC, 256K) 

OPEN TCPCLl 
pram 
jack 
VSECD 

DEFAULTS MODE LIBR LIB TCPOCS 

VSECD .USRl 

PWD 

MKDIR C: \TCPIP\FTPC 
RMDIR C: \TCPIP\FTPC 
MKVSEDIR TCPOCS.FTPB 
RMVSEDIR TCPOCS.FTPB 
STATUS 
LDIR 
BYE 
/* 

/& 

* $$ EOJ 


Figure 68. Sample OC/FTP Client Batch Job 


7.2.6 Customizing the OC/FTP Ciient Transiation Tabies 

This step is optional. Unlike the OC/FTP Server, OC/FTP Client uses an object 
module for the data translation table. This object module 'MTKXLATE' has to be 
linked with other modules to become the OC/FTP Client startup phase - 'FTPC'. 
Refer to Figure 65 on page 103 for the Inclusion of 'MTKXLATE' during the 
assembly of the startup phase. 

The customization of OC/FTP Client translation table consists of the following 
steps: 

1. Change the translation table source code. Please refer to 6.2.5, 

“Customizing the Translation Tables” on page 77 for changing the EBCDIC 
and ASCII tables. 

2. Assemble the translation table source code and catalog It as an object 
module. 

3. Assemble and lInk-edit the 'FTPC' phase to Include the new translation table 
object module. 

4. Restart the online OC/FTP Client. 

Figure 69 on page 106 shows the translation source code in hexadecimal. 

Figure 70 on page 107 shows the job we used to assemble the table and catalog 
It as an object module. Lastly, we resubmit the job shown in Figure 65 on 
page 103 to rebuild the 'FTPC' phase. 
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* $S JOB JlNliyK2.TXLATE, CLASS=A 

// JOB CATXLATE - CATALOG SOURCE TRANSLATION TABLE 
// EXEC LIBR,PARiy^<:MSHP<: 




ACCESS S=TCPOCS.FTPC 

CATALOG MTKXLATE. A REPIACE=YES 



MTKXLATE CSECT 




■k 


TABLE FOR EBCDIC TO ASCII 




ENTRY MTKASCII 



MTKASCII DS 

OF 



■k 


0123456789ABCDEF 

EBCDIC 



DC 

X<:000I02030009007F0000000B0C0D0E0F<: 

OO-OF 



DC 

X<:I01II200000A080018190000ICIDIEIF<: 

10-IF 



DC 

X9000000000000I7IB00000000000506079 

20-2F 



DC 

XC0000I6000000000400000000I4I5001AC 

30-3F 



DC 

X<:200000000000000000005B2E3C282B5D<: 

40-4F 



DC 

X92600000000000000000021242A293B5E9 

50-5F 



DC 

X<:2D2F00000000000000007C2C255F3E3F<: 

60—6F 



DC 

X9000000000000000000603A2340273D229 

70-7F 



DC 

X95B6I62636465666768690000000000009 

80-8F 



DC 

X<:5D6A6B6C6D6E6F707I720000000000009 

90-9F 



DC 

X<:007E737475767778797A0000000000009 

AO-AF 



DC 

XC000000000000000000000000000000009 

BO-BF 



DC 

X97B414243444546474849000000000000C 

CO-CF 



DC 

X<:7D4A4B4C4D4E4F5051520000000000009 

DO-DF 



DC 

X95C00535455565758595A0000000000009 

EO-EF 



DC 

X9303132333435363738390000000000FF9 

FO-FF 


k 


TABLE FOR ASCII TO EBCDIC 




ENTRY MTKEBCDI 



MTKEBCDI DS 

OF 



k 


0123456789ABCDEF 

ASCII 



DC 

XC0001 0203372D2F,2F1 6051SOROCODOFOFC 

OO-OF 



DC 

XC101II2003C3D3226I8I93F271CIDIEIFC 

10-lF 



DC 

X9405A7F7B5B6C507D4D5D5C4E6B604B6I9 

20-2F 



DC 

X<:F0FIF2F3F4F5F6F7F8F97A5E4C7E6E6F<: 

30-3F 



DC 

X<:7CC1C2C3C4C5C6C7C8C9DID2D3D4D5D6C 

40-4F 



DC 

XCD7D8D9E2E3E4E5E6E7E8E980E0905F6D9 

50-5F 



DC 

XC798I82838485868788899I92939495969 

60—6F 



DC 

X<:979899A2A3A4A5A6A7A8A9C06AD0AI07<: 

70-7F 



DC 

X9000000000000000000000000000000009 

80-8F 



DC 

X9000000000000000000000000000000009 

90-9F 



DC 

X9000000000000000000000000000000009 

AO-AF 



DC 

X9000000000000000000000000000000009 

BO-BF 



DC 

X9000000000000000000000000000000009 

CO-CF 



DC 

X9000000000000000000000000000000009 

DO-DF 



DC 

XC000000000000000000000000000000009 

EO-EF 



DC 

XCF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF<: 

FO-FF 


/+ 

/* 





/& 





* $$ EOJ 





Figure 69. Job to Catalog Translation Table Source Code 
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* $S JOB JNM=MrKXLATE, CLASS=A 

* $$ PUN DISP=I,CLASS=A 
// JOB MTKXIATE 

// OPTION DECK 

// LIBDEF SOURCE,SEARCH=TCPOCS.FTPC 
// EXEC ASSEMBLY 

PUNCH <:// JOB CATOBJC 

PUNCH <:// EXEC T JB R, PARM=CCMSHP; A S=TCPOCS .FTPC<:<:<: 
PUNCH <: CATALOG MTKXLATE. OBJ REPLACE=Y« 

END 

/* 

// EXEC ASSEMBLY 

COPY MTKXLATE 
END 

/* 

// EXEC ASSEMBLY 

PUNCH <:/*<: 

PUNCH <:/&&<: 

END 

/* 

/& 

* $$ EOJ 


Figure 70. Job to Assemble and Catalog the Translation Object Module 
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Chapter 8. OC/Line Printer Daemon Installation and Customization 


This chapter covers the installation and customization of OC/Line Printer 
Daemon. It consists of two steps: 

1. Installation - Describes the preparation and procedures to install OC/Line 
Printer Daemon in VSE/ESA 

2. Customization - Provides a detailed explanation of the product customization 


8.1 OC/Line Printer Daemon Instaiiation 

There are two major steps involved to install the product: 

1. Prepare the installation environment for the product 

2. Install the product from tape to the VSE/ESA sublibrary 


8.1.1 Instaiiation Preparation 

To prepare for installation of the OC/Line Printer Daemon the following 
definitions are required: 

• OCS II Gateway to VSE/ESA 

Please refer to Chapter 5, “Defining the OCS II Gateway to the Host” on 
page 41 for the setup instructions. 

• The VSE/ESA library and sublibraries for the product installation 

Library TCPOCS definition is discussed and defined in 6.1, “OC/FTP Server 
Installation” on page 61. 

Sublibrary TCPOCS.LPD is defined using the LIBR DEF SUB command in 
ICCF. This sublibrary is used to store the OC/Line Printer Daemon product, 
and the Line Printer Daemon customization. 

• VSAM catalog and space definitions for printing to a data set instead of a 
printer 

This is an optional step. It is only required if you intend to print to a VSAM 
file instead of a VSE/POWER queue. 

The OC/Line Printer Daemon runs mutually exclusive with the AIX LPD on the 
OCS II Gateway. This means that: 

• The AIX qdaemon subsystem must be stopped. This is done with the 
following command: 

stop -s qdaemon 

If the qdaemon subsystem is automatically started at AIX startup, the 
qdaemon entry must be removed from '/etc/inittab'. 

• If you are using printers attached to the OCS II Gateway from remote Line 
Printer Requestors (LPRs), the following steps must be performed: 

- The printers must be physically connected to an AIX system other than 
the OCS II Gateway. 
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- The local printer queues must be removed from the OCS II Gateway and 
defined in the other AIX system. 

- The former local printer queues on OCS II Gateway must be defined as 
remote printer queues. 


8.1.2 Installation Procedures 

Installation of the product from tape to the product sublibrary involves the 
following steps: 

• Scan the product tape by submitting the jeb in Figure 35 on page 63 to 
VSE/ESA. 

• Use the VSE/ESA II 'Install Product(s) from Tape' panel to generate the job to 
Install the product Into sublibrary TCPOCS.LPD. 

The VSE/ESA II panel also displays the minimum library space requirements 
fer the product. 

• Submit the job to VSE/ESA to install OC/Line Printer Daemon. Our 
installation step took less than 10 minutes. 

There is no installation verification job provided by the software. You may use 
the sample job in Figure 36 on page 64, to verify that the product is recorded by 
MSFIP. Testing of the product can only be performed after the product 
customization. Please refer to Chapter 20, “OC/Line Printer Daemon Operation 
and Examples” on page 273 for the testing and operatien procedures. 


8.2 OC/Line Printer Daemon Customization 

The customization is based on the samples in PRODBLDL.PROC provided by 
OC/Line Printer Daemon. After the product is installed in the product sublibrary, 
PRODBLDL.PROC is punched into an ICCF library. It is then edited inte 
individual jobs to tailor the environment for OC/Line Printer Daemon. 

The OC/Line Printer Daemon customization consists of the following steps: 

• VTAM custemization 

• LPD customization 

• Oueue definition in AIX 

• Startup customization 


8.2.1 VTAM Customization 

The follewing customization tasks are required in VTAM: 

• Define the logmode table and entries for the applications and LUs 

• Specify the APPL definitions for the OC/Line Printer Daemon 

• Add the LU definitions for the OCS II Gateway LUs 
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8.2.1.1 Logmode Table OCSBIND 

The sample job listed In A.6, “OCSBIND MODETAB for OCS Products” on 
page 351 Is used to create the OCSBIND logmode table. OC/Line Printer 
Daemon uses the following entries: 

• OCSLUO for the OCS II Gateway LU used by OC/Line Printer Daemon to 
receive incoming Line Printer Requests 

• OCSLUO for the OCS II Gateway LUs used to send E-mail notifications to the 
print job originators 


8.2.1.2 VTAM APPL Definitions 

The OC/Line Printer Daemon uses: 

• One VTAM APPL to receive incoming line printer requests. This APPL 
definition is shown below 


OCSLPDOl APPL iyDDETAB=(XSBIND, DLOGiyDD=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 

Figure 71. VTAM APPL Statement for OC/Line Printer Daemon Receive Connection 
Key parameters are: 

- MODETAB and DLOGMOD. Identify the appropriate logmode table entry. 

- NVPACE in AUTH parameter. Turns off VTAM pacing for FTP. 

- ACQ in AUTH parameter. Allows OC/FTP Server to acquire LUs. 

- EAS=2. Allows two concurrent sessions for OC/FTP Server. 

• Multiple VTAM APPLs to send E-mail notifications. The OC/Line Printer 
Daemon product allows the usage of the OC/FTP Client VTAM definitions as 
described in 7.2.2, “VTAM Customization” on page 83. 

By using the OC/FTP Client VTAM definitions the E-mail notifications will be 
sent using the set of connections available to the OC/FTP Client. 

- Warning - 

If all connections assigned to OC/FTP Client are in use, no E-mail 
notification will be sent. 


These APPL definitions are only required if you intend to use the E-mail 
notification feature described in 8.2.2.1, “LPDCONF Member” on page 112. 


8.2.1.3 VTAM LU Definition 

The completed OCS II Gateway LUs definition is listed in Figure 24 on page 47, 
and A.3, “VSE TCPSW.B Switched Major Node” on page 342. 

Figure 72 on page 112 lists the LU definitions used by OC/Line Printer Daemon. 
We defined one LU for the Line Printer Daemon and used the LUs defined for the 
OC/FTP Client as shown in Figure 52 on page 87. The number of LUs depends 
on the installation requirements. 
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IPFT2S9I LU 

LOCADDR=2, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=OCSBIND, 

c 


iyDLTAB=VIMyDL, iyDLENT=VSELU2A, 

c 


SSCPEiy^USSSCS, USSTAB=VIMUSSTR 



Figure 72. Logical Unit Definitions for OC/Line Printer Daemon 
The key parameters are: 

• The LU name. Must match the LU name in the OCS II Gateway 
customization 

• LOCADDR. Must match the LU number in the OCS II Gateway customization. 

• MODETAB and DLOGMOD. Identify the appropriate logmode table entry. 

8.2.2 LPD Customization 

This section covers the definitions required by OC/Line Printer Daemon. 

8.2.2.1 LPDCONF Member 

The LPDCONF member is used to: 

• relate the LPD function to VTAM 

• define the E-mail Gateway used by the E-mail notification feature 

• define the printer queues available to remote Line Printer Requestors 

Figure 73 on page 113 lists the job we tailored. 
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* $$ JOB JNM=LPDCONF,DISP=D,PRI=3,NTEY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB LPDCONF 

// EXEC LIBR,PARM=<:MSHP<: 

ACCESS SUB T ,TR =TCPOCS. PARMT ,TR 

CATALOG LPDCONF.LPDPARM EOD=$$ REPLACE=Y 

* -* j 

* THIS MEMBER WILL BE USED TO IDENTIFY VARIOUS INITIAL- */ 

* IZATION CHARACTERISTICS FOR ALL LPD SESSION USERS. */ 

* THIS MEMBER NAME MUST NOT BE CHANGED. */ 

* - -k j 

■k - -k j 

* THE GATEWAY STATEMENT IDENTIFIES THE GATEWAY LU CHOICE. */ 

* - -k j 

GATEWAY IPFT2S9I 

* - -k j 

* THE MAIL STATEMENT IDENTIFIES THE MAIL IP ADDRESS. */ 

* - -k j 

MAIL 192.61.100.81 

* - -k j 

* THE ACB STATEMENT IDENTIFIES THE VTAM ACB CHOICE. */ 

* - -k j 

ACB OCSSMPOl 

* - -k j 

* THE QUEUE STATEMENT (S) IDENTIFY REMOTE QUEUE ELEMENTS. */ 

■k - k ! 

QUEUE LPDFILE DDNAME=LPDFILE 
QUEUE SYSOUT SYSOUT=A,H=NO 
QUEUE VSEPRT SYSOUT=A, MAIL=NO 
QUEUE VSEPRTM SYSOUT=A, MAIL=YES 
$$ 

/* 

/& 

* $$ EOJ 


Figure 73. LPDCONF Member for OC/Line Printer Daemon 

Listed below is a brief description of the parameters: 

• GATEWAY. Identifies the VTAM LU used by the OC/Line Printer Daemon. It 
must match the LU defined for the OC/Line Printer Daemon in the VTAM LU 
Definition. 

• MAIL. The IP address of the Mail server. We used the mail server on the 
RISC/6000 used for the OpenConnect Server II Gateway. 

• ACB. Relates the LPD function to VTAM. It must match the name defined for 
OC/Line Printer Daemon in the VTAM APPL statement. 

• QUEUE. Each usage of the OUEUE parameter defines a Line Printer queue 
for remote Line Printer Requestors. The OUEUE parameter supports the 
following operands: 

- QUEUENAME The name of the printer queue to be specified by the 
remote Line Printer Requestors. 

- QUEUETYPE Jh\s operand is used to determine the destination of the 
print queue specified on the QUEUENAME operand. The operand is built 
using: 

- The DDNAME= operand if printing to a data set 
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- A combination of the SYSOUT=, D = , and F= operands if printing to 
the VSE/POWER LSI queue. The default value for this operand is 

SYSOUT=A, F=STD 

- DDNAME= The standard label of the file into which Line Printer 
Requests for this queue are stored. 

This standard label must be defined using a DLBL statement. 

- Note - 

OC/Line Printer Daemon supports any VSE/VSAM SAM ESDS and 
most OEM DASD manager organisations. We only tested with 
VSE/VSAM SAM ESDS files with the print to file feature. 


This operand is mutually exclusive to the SYSOUT=, D = , and F= 
operands. 

- SYSOUT= The Identifier of the VSE/POWER LST class used for printing 
Line Printer Requests spooled to this queue. This operand is mutually 
exclusive with the DDNAME operand. 

- D= The VSE/POWER destination assigned to Line Printer Requests 
spooled to this queue. 

- Note - 

In contrast to the VSE/POWER DEST=(node,userid), node and userid 
on this operand are not separated by a comma but a dot and are not 
enclosed by brackets. 

D=node.userid 


This operand is mutually exclusive with the DDNAME operand. 

- F= The VSE/POWER form assigned to Line Printer Requests spooled to 
this queue. This operand is mutually exclusive with the DDNAME 
operand. The default for this operand is F=STD. 

• MAIL= specifies if the originator of the Line Printer Request should be 
notified by E-mail when his request is being queued. The default for this 
operand is MAIL=YES. 

- Note - 

To use this option, the VTAM definitions for the OC/Line Printer Daemon 
E-mail function must be performed. We used the OC/FTP Client 
definitions as defined in 7.2.2, “VTAM Customization” on page 83. 


• H= specifies if the print output should be preceded by the LPD banner. For 
a more detailed description of the LPD banner, refer to 8.2.5, “Customizing 
the OC/Line Printer Daemon Print Banner” on page 119. 

The default for this operand is FI=Y. 

For our LPDCONF member as shown in Figure 73 on page 113 this means that 
there are four queues available to remote Line Printer Requestors. 
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Queue name 

Line print requests to this queue wili be ... 

LPDFILE 

... preceded by the LPD banner and then stored in the file with label 
LPDFILE. 

After the request has been successfully filed, the originator will be 
notified by E-mail 

SYSOUT 

... spooled to VSE/POWER LST queue with CLASS=A,FORM=STD 

VSEPRT 

... preceded with the LPD banner and added to VSE/POWER LST 
queue with CLASS=A,FORM = STD. 

After the request has been successfully spooled to the VSE/POWER 
LST queue, the originator will be notified by E-mail 

VSEPRTM 

... preceded with LDP Banner, added to VSE/POWER LST queue with 
CLASS^A, FORM^STD. 

After the request has been successfully spooled to the VSE/POWER 
LST queue, the originator will be notified by E-mail 


Table 6. LPD Queue Definitions used in our Environment 


8.2.2.2 Additional Configuration Members 

In order to use the E-mail notification function of the OC/Line Printer Daemon the 
feiiowing members have te be suppiied: 

• FAPPL. Defines the programs used by E-maii notificatien 

• NETWORKS. Defines IP network names and addresses 

• NETWORKS LU List. Allocates LUs to the networks defined in the 
NETWORKS member. 

• RESOLVER. Defines the IP domain name servers. 

• NETMASK. Defines the IP subnet mask. 

Since we are using the OC/FTP Client cennectiens for the E-mail netification, we 
just refer to these members in the OC/Line Printer Daemon startup job as 
described in 8.2.3.2, “Create the LPD Startup Job” on page 117. 


8.2.3 Startup Customization 

The follewing preparation tasks are required to bring up OC/Line Printer 
Daemon: 

• Build the executable phases and apply site protection 

• Create the LPD startup job 


8.2.3.1 Build the Executable Phases and Apply Site Protection 

Figure 74 on page 116 lists the job we used to assemble and link-edit the 
OC/Line Printer Daemon phase into the TCPOCS.LPD sublibrary and additienally 
apply the site protection modification. The source ef this job is provided in 
PRODBLDL.PROC. 


Chapter 8. OC/Line Printer Daemon instaiiation and Customization 115 




* $$ JOB JNiy^PRODBLDL,DISP=D,PRI=3,NIFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LSI CLASS=A 
// JOB PRODBLDL 

* -k 

* BUILDING COMPONENT EXECUTION MODULE (S) . * 

* k 

// OPTION CATAL,NOXREF 

// LIBDEF OBJ,SEARCH=TCPOCS.LPD,TEMP 

// LIBDEF SOURCE,SEARCH=TCPOCS.LPD,TEMP 

// LIBDEF PHASE,SEARCH=TCPOCS.LPD,CATALOG=TCPOCS.LPD,TEMP 

/* 

PHASE LPDMAIL, * 

INCLUDE LPDMAIL 

/* 

// EXEC PGiy^LNKEDT,PARiy^<:MSHP<: 

/* 

PHASE LPD,* 

INCLUDE LPDTVT 
INCLUDE LPD 
INCLUDE LPDCPU 
INCLUDE LPDCONF 
INCLUDE LPDALLOC 
INCLUDE IJDFAZZW 
INCLUDE SOCK$AM 
INCLUDE SOCK$MF 
INCLUDE TABLEOOl 
INCLUDE SOCK$PL 
INCLUDE SOCK$VO 
INCLUDE SOCK$EX 
INCLUDE SOCK$CIS 
INCLUDE SOCK$V62 
INCLUDE SOCK$TR 
INCLUDE SOCK$DNR 
INCLUDE SPAM 
INCLUDE 

/* 

// EXEC PGM^ASSEMBLY 
COPY LPDXLATE 
END , 

/* 

// EXEC PG1>L=ASSEMBLY 
COPY LPDBANER 
END , 

/* 

ENTRY LPD 

/* 

// EXEC PGiy^LNKEDT,PARiy^<:MSHP<: 

/* 


Figure 74 (Part 1 of 2). Build the Executable Phases for OC/Line Printer Daemon and 
Apply Site Protection 
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★ -k 

★ APPLYING LICENSE SITE PROTECTION MODIFICATION. * 

★ k 

// EXEC PCN^MSHP 

REMOVE 5758-PC-4I8-I00 APAR=SP4I80I 
CORRECT 5758-PC-4I8-100:SP4I80I IRREVOKABLE 
AFFECTS PHASE=LPD 

ALTER 0000 /I6/AA:DE90F69F2F7977885B6B6DDADCD2FB8B 
ALTER 0010 /I6/AA:A3B2A6BI057D02D8DFC4708742F0DA4E 
ALTER 0020 /I6/AA: 89CDBAI9A46646A3DB24D7I2EBCA679I 
RESOLVES ^LICENSE SITE PROTECTIONS 

/* 

//IF $RC<=4 THEN 
// GOTO BYPASS 

★ k 

★ LICENSE SITE PROTECTION FAILURE; TERMINATED. * 

★ k 

// PAUSE 
// GOTO SEOJ 
/* 

/. BYPASS 

★ $$ EOJ 


Figure 74 (Part 2 of 2). Build the Executabie Phases for OC/Line Printer Daemon and 
Apply Site Protection 


8.2.3.2 Create the LPD Startup Job 

The source of this job is provided in EXAMPLEL.PROC. We added the necessary 
JCL to start OC/Line Printer Daemon in a dynamic partition. 

Figure 75 lists the job we used. 


* $$ JOB JNiy^LPD,CLASS=Y,DISP=L,NTFY=YES 

* $$ LST CLASS=A 

// JOB LPD START LINE PRINTER DAEMON 
// LOG 

// DLBL OCSPLIB,STCPOCS.PARMLIB.FTPS 

// DLBL IJSYSOl, SIJSYSOIS, 0,VSAM,CAT=VSESPUC,DISP= (,KEEP), C 

RECSIZE=4096,RECORDS=(000512,000256) 

// DLBL LPDFILE,SLPDFILES,0,VSAM,CAT=VSESPUC,DISP=(,KEEP), C 

RECSIZE=4096,RECORDS=(000512,000256) 

// LIBDEF *,SEARCH=(TCPOCS.PARMLIB,TCPOCS.LPD),TEMP 
// EXEC PGiyh=LPD, SIZE=LPD 
/* 

* $$ EOJ 


Figure 75. OC/Line Printer Daemon Startup Job 

The DLBL statements in this job are used for the following reasons: 

• DLBL OCSPLIB causes OC/Line Printer Daemon to use the configuration 
members needed for E-mail notification from TCPOCS.PARMLIB with a 
member type of FTP. These are the same members used when setting up the 
OC/FTP Client. 
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• DLBL IJSYS01 changes the VSAM characteristics of the IJSYS01 workfiie in 
order to use this fiie as a buffer for OC/Line Printer Daemon. 

• DLBL LPDFILE specifies the characteristics for the LPDFILE data set that wili 
be impiicitiy defined as a VSAM SAM ESDS fiie when a print request for the 
LPDFILE queue is performed. 

This job is submitted to the POWER RDR queue and is ready to start. The 
operatien and testing of OC/Line Printer Daemen are discussed in Chapter 20, 
“OC/Line Printer Daemon Operation and Exampies” on page 273. 


8.2.4 Customizing the OC/Line Printer Daemon Transiation Tabies 

This step is optionai. OC/Line Printer Daemon uses an assembier seurce fiie 
'LPDXLATE.A' for the data transiation tabie. Refer to Figure 74 on page 116 for 
the inciusion of 'LPDXLATE' during the assembly of the startup phase. 

The customization of OC/Line Printer Daemen transiation tabie consists of the 
foliewing steps: 

1. Change the transiation tabie source code. Piease refer to 6.2.5, 

“Customizing the Transiation Tabies” on page 77 for changing the EBCDIC 
and ASCII tables. 

2. Assemble and link-edit the 'LPD' phase to include the new translation table 
object mcdule. 

3. Restart the OC/Line Printer Daemon. 

Figure 76 on page 119 shows the translation source code in hexadecimal. 

Finally, we resubmit the job shown in Figure 74 on page 116 to rebuild the 'LPD' 
phase. 
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* $$ JOB JI\IM=CATXLATE, CLASS=A 

// JOB CATXLATE - CATALOG SOURCE TRANSLATION TABLE 
// EXEC LIBR,PARiy^<:MSHP<: 

ACCESS S=TCPOCS.LPD 

CATALOG LPDXLATE.A REPIACE=YES 

LPDXLATE CSECT 



■k 

k _ 


TABLE FOR ASCII TO EBCDIC 




DC 

A(EPDEBCDI) ADDRESS OF ASCII TO EBCDIC TABLE 


LPDEBCDI DS 

OF 





0123456789ABCDEF 

ASCII 



DC 

X<:00010203372D2E2F1605150B0C0D0E0F<: 

OO-OF 



DC 

X<:I0III2003C3D3226I8I93F27ICIDIEIF<: 

lO-IF 



DC 

X<:405A7F7B5B6C507D4D5D5C4E6B604B61C 

20-2F 



DC 

X<:F0FIF2F3F4F5F6F7F8F97A5E4C7E6E6F<: 

30-3F 



DC 

X<:7CCIC2C3C4C5C6C7C8C9DID2D3D4D5D6C 

40-4F 



DC 

X<:D7D8D9E2E3E4E5E6E7E8E980E0905F6D<: 

50-5F 



DC 

X<:798182838485868788899192939495969 

60—6F 



DC 

X<:979899A2A3A4A5A6A7A8A9C06AD0AI07C 

70-7F 



DC 

XC000000000000000000000000000000009 

80-8F 



DC 

X9000000000000000000000000000000009 

90-9F 



DC 

X9000000000000000000000000000000009 

AO-AF 



DC 

X9000000000000000000000000000000009 

BO-BF 



DC 

X9000000000000000000000000000000009 

CO-CF 



DC 

X9000000000000000000000000000000009 

DO-DF 



DC 

X9000000000000000000000000000000009 

EO-EF 



DC 

X9F0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFFC 

FO-FF 


/+ 





/* 





/& 





* $$ EOJ 





Figure 76. Job to Catalog Translation Table Source Code 


8.2.5 Customizing the OC/Line Printer Daemon Print Banner 

This step is optionai. OC/Line Printer Daemon uses an assembier source 
member 'LPDBANER.A' that contains the banner that precedes every Line 
Printer Request. Refer to Figure 74 on page 116 for the inciusion of 
'LPDBANER' during the assembiy of the startup phase. 

The customization of OC/Line Printer Daemon print banner consists of the 
foiiowing steps: 

1. Change the print banner source code. 

- Warning - 

Foiiow the instructions in the defauit LPDBANER.A member when 
changing the Print Banner source code. 


2. Assembie and iink-edit the 'LPD' phase to inciude the new print banner 
object moduie. 

3. Restart the OC/Line Printer Daemon. 
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Figure 77 on page 120 shows the translation source code in hexadecimal. 
Finally, we resubmitted the job shown in Figure 74 on page 116 to rebuild the 
'LPD' phase. 


* $$ JOB JIN1M=CATBANER, CLASS=A 

// JOB CATBANER - CATALOG SOURCE PRINT BANNER 
// EXEC LIBR,PARiy^<:MSHP<: 

ACCESS S=TCPOCS.LPD 

CATALOG LPDBANER.A REPLACE=YES 

TITLE CLPD - BANNER DEFINITION FILEC 

■k 

* PROGRAM: LPDBANER 

* PURPOSE: Allow flexability for defining the banner page data 

* printed by the LPD Deamon. 

* WRITTEN: 07/15/96 

* SYSTEM: VSE/ESA 2.1 

■k 

* Those characters defined from BANERIN thru BANERIE define the 

* left half of the banner. 

* Those characters defined from BANER2N thru BANER2E define the 

* right half of the banner. 

* Change the characters between the C.C only and reassemble 

* and link using the provided sairple jcl as a guide. 

* Warning: Both sides of the banner must contain the same nuirber 

* of lines. 

■k 


LPDBANER CSECT 


DC 

A(BANERl) 





DC 

A(BANER2) 





DC 

A (BANERl EE) 





DC 

A (RANER2EE) 





DC 

CLSCLPDBANERC 

CSECT NAME 




DC 

CLSCOS.OO.OOC 

TIME 




DC 

CL8<:07/15/96<: 

DATE 




BANERl DS 

OH 





BANERIN DS 

OH 





DC CL60<: 


0000000 CCCCCCC 

SSSSSS 

/9 

DC CL60<: 


00 00 cc 


SS SS 

/ 9 

DC CL60<: 


00 00 cc 


SS 

/ 9 

DC CL60<: 


00 00 cc 

SS 

SS / b 

DC CL609 


0000000 cccccccc 

SSSSSSS / 

9 

BANERIE DS 

OH 





BANERl EE EQU 

(*-BANERl)/60 

NUMBER OF LINES 




BANER2 DS 

OH 





BANER2N DS 

OH 





DC CL60C 

LL PPPPPPPP DDDDDDDD 



9 

DC CL609 

LL PP PP DD DD 



9 

DC CL609 

LL PPPPPPPP 

DD DD 



9 

DC CL609 LL PP 

DD DD 



9 

DC CL60C T,T,T,T,T,T, PP 

DDDDDDDD 



9 

BANER2E DS 

OH 





BANER2EE EQU 

(*-BANER2)/60 

NUMBER OF LINES 





/+ 

/* 

/& 

* $$ EOJ 


Figure 77. Job to Catalog Print Banner Source Code 
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8.2.6 Queue Definition in AIX 

Every line printer queue for OC/Line Printer Daemon as described in 8.2.2, “LPD 
Customization” on page 112 should also be defined on the OCS II Gateway 
RISC/6000. This can be easily accomplished by the following SMIT path: 

• Spooler (Print Jobs) 

• Manage Remote Printer Subsystem 

• Client Services 

• Remote Printer Queues 

• Add a Remote Printer Queue 

Figure 78 shows the definitions used for the SYSQUT queue : 


Add a Remote Queue 

Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 


* NAME of queue to add 
ACTIVATE the queue? 

Will this become the DEFAULT queue? 

Queueing DISCIPLINE 
ACCOUNTING FILE pathname 

* DESTINATION HOST for remote jobs 

* Pathname of the SHORT FORM FILTER for queue 

status output 

* Pathname of the LONG FORM FILTER for queue 

status output 

* Name of QUEUE on remote printer 

* NAME of device to add 

* BACKEND PROGRAM pathname 

Fl=Help F2=Refresh F3=Cancel 

Esc+5=Reset F6=Command F7=Edit 

F9=Shell F10=Exit Ente 2 o=Do 


[Entry Fields] 

[sysout] 

yes + 

no + 

first come first semve + 
[] 

[192.61.100.81] 
[/usr/lpd/aixshort] + 

[/usr/lpd/aixlong] + 


[sysout] 

[sysout] 

[ /usr/Ipd/rembak] 
F4=List 
F8=Image 


Figure 78. OC/Line Printer Daemon Queue Definition on OCS II Gateway 

Listed below is a short description of the entry fields: 

• NAME of queue to add. The name under which the QC/Line Printer Daemon 
print queue will be known to AIX. We recommend to use the same name as 
defined in QC/Line Printer Daemon. 

• DESTINATION HOST for remote jobs. The hostname or IP-address of the 
QCS II Gateway. 

• Name of QUEUE on remote printer. The name of the QC/Line Printer 
Daemon print queue as specified in the LPDCQNF member. 

• NAME of device to add. Use the same name as for Name of QUEUE on 
remote printer for this field. 

• All other SMIT fields contain default values that should not be overwritten. 
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Chapter 9. OC/RSH Client Installation and Customization 

This chapter covers the installation and customization of the OC/RSH Client. It 
consists of two steps: 

1. Installation - Describes the preparation and procedures to Install OC/RSH 
Client in VSE/ESA 

2. Customization - Provides an explanation of the product customization. 

The installation instructions provided in this chapter assume you already have 
Installed and are using the OCS II Gateway. The OC/RSH Client Is an extension 
to the OC/FTP Client program. The OC/FTP Client has already been Installed 
(see Chapter 7, “OC/FTP Client Installation and Customization” on page 81) and 
we are using the same parameter library members. 


9.1 OC/RSH Client Installation 

There are two major steps involved to Install the product: 

1. Prepare the Installation environment for the product 

2. Install the product from tape to the VSE/ESA sublibrary 


9.1.1 Installation Preparation 

To prepare for installation of the OC/RSH Client the following definitions are 
required: 

• OCS II Gateway to VSE/ESA 

Please refer to Chapter 5, “Defining the OCS II Gateway to the Host” on 
page 41 for the setup instructions. 

• The VSE/ESA library and sublibraries for the product Installation 

Library TCPOCS definition is discussed and defined in 6.1, “OC/FTP Server 
Installation” on page 61. 

Sublibrary TCPOCS.RSH is defined using the LIBR DEF SUB Librarian 
command. This sublibrary is used to store the OC/RSH Client product, and 
the RSH client customization. 


9.1.2 Installation Procedures 

Installation of the product from tape to the product sublibrary involves the 
following steps: 

• Use the VSE/ESA II Installation dialog to generate the Installation jobstreams. 

• Scan the product tape by submitting the job in Figure 35 on page 63. 

• Submit the job created using the VSE/ESA 11 Installation dialog to Install 
OC/RSH Client into the TCPOCS.RSH sublibrary. 

There is no installation verification job provided by the software. You may use 
the sample job In Figure 36 on page 64 to verify that the product is recorded by 
MSHP. Testing of the product can only be performed after the product 
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customization. Piease refer to Chapter 21, “OC/RSH Client Operation and 
Examples” on page 281 for the testing and operatien procedures. 


9.2 OC/RSH Client Customization 

The customization is based en the samples in PRODBILD.PROC provided by 
OC/RSH Client. After the preduct is installed in the product sublibrary, 
PRODBILD.PROC is punched into an ICCF library. It is then edited into individual 
jobs to tailor the envirenment for OC/RSH Client. 

The OC/RSH Client custemization consists of the following steps: 

• VTAM custemization 

• CICS customization 

• RSH client customizatien 

• Remete Cemmand Execution Access at RS/6000 

• Startup customization 

Since we have already installed the OC/FTP Client and no additional LUs are 
being added to support OC/RSH Client, ne further VTAM and RSH customizatien 
is required. 


9.2.1 VTAM Customization 

The follewing customization tasks are required in VTAM: 

• Define the logmode table and entries for the applicatiens and LUs 

• Specify the APPL definitions for the OC/RSH Client 

• Add the LU definitions for the OCS II Gateway LUs 

These tasks are the same as for the OC/FTP Client and described in Chapter 7, 
“OC/FTP Client Installation and Customization” on page 81. 


9.2.1.1 VTAM APPL Definitions 

In addition to the discussions in Chapter 7, “OC/FTP Client Installation and 
Customization” on page 81 an understanding of how RSH works is helpful. 

Figure 79 on page 126 illustrates the operation of the OC/RSH Client and the 
relationships between FTP and RSH clients within the OC/FTP Client. 

• VTAM, CICS and OCS II Gateway are initialized, and the OCS II Gateway is 
connected to VTAM. 

• The OC/RSH Client is executed within the OC/FTP Client dynamic partition, 
the communication program OCSFTP62 automatically establishes the parallel 
sessions with the corresponding ISC modules in the CICS partition. The 
number of concurrent sessions is determined in the OCSFTP62 APPL 
statement. The OC/RSH Client is now ready to accept RSH transactiens from 
CICS terminals. OCSFTP62 handles alse the requests from FTP transactions. 

• When the RSH transaction is entered from a CICS terminal, the OC/RSH 
Client online interface is initialized. 
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When the OC/RSH Client is invoked from a batch job, the OC/RSH Client 
runs in the batch dynamic partition and initializes the batch interface. 

After the online or batch interface is started, the OC/RSH Client must 'know' 
its parameter library. This is done via the OC/RSH Client PARMLIB 
command. Now OC/RSH Client is ready to send commands to a remote 
TCP/IP host. 

For each command execution, the OC/RSH Client dispatches a program with 
the name 'OCSFTPnn', where 'nn' ranges from 01 to the maximum number of 
sessions allowed. OCSFTPnn creates an LU-LU session using the first 
available LU In the OCS II Gateway. 

OCSFTPnn Is a VTAM application and must be defined In the VTAM APPL 
major node. Keep in mind that we use the same applications we defined for 
OC/FTP Client. 
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Figure 79. OC/RSH Client Operation 


9.2.2 CICS Customization 

This section covers the definitions in CICS to enabie VSE/ESA users to use the 
OC/RSH Client oniine. Our definition is based on the sampies in 
PRODBILD.PROC provided by OC/RSH Ciient. We used the CEDA transaction to 
define the foilewing resources to CiCS: 

• Connection VSE 

• Session VSESESS 

• Program APPCFTPC 
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Transaction RSH 


Connection, session and program definitions are the same as described for 
OC/FTP Ciient (see Chapter 7, “OC/FTP Ciient Instaliation and Customizatien” 
on page 81). We oniy show the definition of the transaction 'RSFI' in the section 
beiow. 


9.2.2.1 Define the "RSH" Transaction 

CEDA DEF TRAN(RSFI) is used to define the OC/RSFI Ciient transaction RSFI to 
CICS as shown beiow. 


CEDA DEFINE 


TRansaction 

RSH 



Group 

VSEGROUP 



PRCGram 

APPCFTPC 



TWasize 

00256 

0-32767 


PROFile 

PArtitionset 

DFHCICST 



STatus 

Enabled 

Enabled | 

Disabled 

PRIMedsize 

00000 

0-65520 


REMOTE ATTRIBUTES 



DYnamic 

REMOTESystem 

REMOTEName 

TRProf 

No 

No 1 Yes 


Localq 

SCHEDULING 


No 1 Yes 


PRIOrity 

001 

0-255 


TClass 

No 

No 1 1-10 


ALIASES 




Alias 

TAskreq 

Xtranid 




RECOVERY 




DTimout 

No 

No 1 1-7000 

Indoubt 

Backout 

Backout 1 

Commit I Wait 

REStart 

No 

No 1 Yes 


SPurge 

No 

No 1 Yes 


TPurge 

No 

No 1 Yes 


DUnp 

Yes 

Yes 1 No 


TRACe 

Yes 

Yes 1 No 


SECURITY 




Extsec 

No 

No 1 Yes 


TRANsec 

01 

1-64 


RSL 

Public 

0-24 1 Public 

RSLC 

No 

No 1 Yes 

External 


The key parameters are: 

• TRANSACTION. The name of the OC/RSFI Client transaction. 

• GROUP. The name of the group to which this definition beiongs. 

• PROGRAM. The first CICS program that this transaction invokes. 

• TWASIZE. The transaction work area. 256 bytes is recommended by OCS. 
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9.2.3 RSH Client Customization 

This section covers the definitions required for the RSH olient. The following 
library members are needed: 

• FAPPL. Defines the programs used by the OC/RSH Client. 

• NETWORKS. Defines IP network names and addresses. 

• NETWORKS LU List "IPFNET'. Allocates LUs to the networks defined In the 
NETWORKS member. 

• HOSTS. Defines TCP/IP IP addresses and host names. 

• NETMASK. Defines the IP subnet mask. 

These members have already been set up for the OC/FTP Client in Chapter 7, 
“OC/FTP Client Installation and Customization” on page 81 and filed In 
sublibrary TCPOCS.FTPC. 


9.2.4 Prepare for Remote Command Execution Access at an AIX Host 

The OC/RSH Client is able to exeoute a command or a sequence of oommands 
on a remote TCP/IP host only if a user is allowed to do so. That means, access 
for remote command execution first has to be provided on the 'target' TCP/IP 
host. 

To understand the remote command execution, It is necessary to know that the 
following authorization information is passed from the OC/RSH Client on 
VSE/ESA to the RSH Server on the target TCP/IP node: 

Client User ID 

The user ID of the RSH olient. When using the OC/RSH Client 
batoh program this is always 'batch'. 

User ID at the RSH Server 

The user ID to be used at the looal RSH server. This Is specified 
in the -I flag of the RSH command and Is mandatory In the 
OC/RSH Client. 

To obtain the authorization for remote command execution on a TCP/IP RSH 
server host the following Is required: 

1. A valid user ID at the RSH server 

2. The VSE user ID for the RSH client needs to be authorized for remote 
command execution. This can be done in two different ways: 

a. Specifying the client user ID as well as the VSE/ESA system itself In the 
/etc/hosts.equiv file of the RSH server. Then no further authorization 
check Is performed. Figure 80 on page 129 shows the /etc/hosts.equiv 
file we used. 

b. The client user ID as well as the VSE/ESA system itself is defined in the 
$HOME/.rhosts file; then the name of the server system needs also to be 
defined In the SHOME/.rhosts file. Figure 81 on page 129 shows the 
$HOME/.rhosts file we used. 
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aix320 

# allows access to VSE/ESA system 

aix320 batch 

# allows access to VSE/ESA RSH Batch program itself 

aix320 maru 

# allows access to VSE/ESA user maru 

aix320 wacker 

# allows access to VSE/ESA user wacker 

aix320 jyiu 

# allows access to VSE/ESA user jyiu 

aix320 kami 

# allows access to VSE/ESA user kami 

aix320 user 

# allows access to VSE/ESA user user 

# other VSE/ESA host users need access via SHOME/.rhosts file 


Figure 80. Sample/etc/hosts.equiv File 


aix320 wack # allows access to VSE/ESA user wack 


Figure 81. Sample $HOME/.rhosts File for User wack 


9.2.5 Startup Customization 

The following is required to bring up the OC/RSH Client: 

• Build the executable phases 

• Run the site protection modification job 

• Create the RSH Client startup job 

• Create the sample RSH client batch job 


9.2.5.1 Build the Executable Phase 

Figure 82 lists the job we used to assemble and link-edit the OC/RSH Client 
phase into the TCPOCS.RSH sublibrary. The source of this job is provided in 
PRODBILD.PROC. 


* $$ JOB JNiyK3tASM,CLASS=5,DISP=D,NTFY=YES 
// JOB CRASH 

* BUILDING COMPONENT EXECUTABLE PHASE 
// OPTION CATAL,NOXREF 

// LIBDEF OBJ,SEARCH= (TCPOCS.RSH,TCPOCS.FTPC),TEMP 
// LIBDEF PHASE,CATALOG=TCPOCS.RSH,TEMP 
PHASE RSHC, * 

INCLUDE RSHMAIN 
INCLUDE RSHCPU 
INCLUDE RSHBTCH 
INCLUDE RSHSMP 
INCLUDE SOCK$AM 

/* 

ENTRY RSH 

/* 

// EXEC PGiyh=LNKEDT,PARiy^<:MSHP<: 

/* 

/& 

* $$ EOJ 


Figure 82. Build the Executable Phases for OC/RSFI Client 
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9.2.5.2 Run the Site Protection Modification Job 

Figure 83 lists the job we used for the OCS license protection. The source of 
this job is provided in PRODBILD.PROC. 


* $$ JOB JNiyN0RASM2,CLASS=5,DISP=D,NTFY=YES 
// JOB CRASM2 

* -k 

* APPLYING LICENSE SITE PROTECTION MODIFICATION. * 

* k 

// EXEC PGiyh=MSHP 

REMOVE 5758-PC-3I7-2I5 APAR=SP3I70I 
CORRECT 5758-PC-3I7-2I5:SP3I70I IRREVOKABLE 
AFFECTS PHASE=RSHC 

ALTER 0000 /I6/AA:DD3I26AC98742608270864AACDB6B274 
ALTER 0010 /I6/AA:A34C76D33I729CA8F65F7DAB42I2294F 
ALTER 0020 /I6/AA:FBCDI709EE4BI035ID4D5CFCFC9F429I 
RESOLVES CLICENSE SITE PROTECTIONC 

/* 

/& 

* $$ EOJ 


Figure 83. Site Protection Job for OC/RSH Client 


9.2.5.3 Create the RSH Client Startup Job 

The source of this job is provided in RSHSAMP.PROC. We added the necessary 
JCL to start OC/FTP Client in a dynamic partition. 

Figure 84 lists the job we used. 


* $$ JOB JNiyp=FTPC,DISP=L,PRI=3,NTFY=YES,LDEST=(,RSCS),CLASS=Z 

* $$ LST CLASS=A 

// JOB FTPC STARTS FTP AND RSH CLIENT 

// LIBDEF *,SEARCH=(TCPOCS.FTPC,PRD2.CONFIG),TEMP 

// EXEC PGiyKX:SFTPC,SIZE=(OCSFTPC,256K) 

/* 

/& 

* $$ EOJ 


Figure 84. OC/RSH Client Startup Job 

This job is submitted to the POWER RDR queue and is ready to start. Operation 
and test of the OC/RSH Client is discussed in Chapter 21. “OC/RSH Client 
Operation and Examples” on page 281. 
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9.2.5.4 Create the Sample RSH Client Batch Job 

The sample RSH client job in RSHSAMP.PROC may be customized, to start and 
execute OC/RSH Client in a batch partition. 

Be sure that user names and commands for AIX are specified in lower case, 
otherwise the command will not execute as expected. When preparing the RSH 
batch job with the ICCF editor use the editor command "CASE M" to enable input 
in mixed mode. Figure 85 lists the job we tailored to test RSH functions. 


* $$ JOB JNM=CRBATCH,DISP=L,PRI=3,NIFY=YES,LDEST=(,RSCS) ,CLASS=Y 

* $$ LST CLASS=A 
// JOB CRBATCH 

// LIBDEF PHASE,SEARCH=TCPOCS.FTPC,TEMP 
// LIBDEF SOURCE, SEARCH=TCPOCS.FTPC, TEMP 
// EXEC PGMh=RSHC, SIZE= (RSHC, 256K) 

PARMLIB TCPOCS.FTPC 

RSH AIX320 -1 wacker -n date; echo $HOME;ls -1 
RSH AIX320 -1 wacker -n cat /etc/hosts 
RSH AIX320 -1 maru -n Is -1 grep Oct 
RSH 192.61.100.81 -1 maru -n Is -1 grep Oct 
BYE 
/* 

/& 

* $$ EOJ 


Figure 85. Sample OC/RSH Client Batch Job 
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Chapter 10. OC/TELNET FS Installation and Customization 


This chapter covers the installation and customization of OC/TELNET FS. It 
consists of two steps: 

1. Installation - Describes the preparation and procedures to install OC/TELNET 
FS in VSE/ESA 

2. Customization - Provides a detailed explanation of the product customization 


10.1 OC/TELNET FS Installation 

There are two major steps involved to install the product: 

1. Prepare the installation environment for the product 

2. Install the product from tape to the VSE/ESA sublibrary 


10.1.1 Installation Preparation 

To prepare for installation of the OC/TELNET FS the following definitions are 
required: 

• OCS II Gateway to VSE/ESA 

Please refer to Chapter 5, “Defining the OCS II Gateway to the Flost” on 
page 41 for the setup instructions. 

• The VSE/ESA library and sublibraries for the product installation 

Library TCPOCS definition is discussed and defined in 6.1, “OC/FTP Server 
Installation” on page 61. 

Sublibrary TCPOCS.TNFS is defined using the LIBR DEF SUB command in 
ICCF. This sublibrary is used to store the OC/TELNET FS product, and the 
TELNET client customization. 

• VSAM catalog and space definitions for the TELNET customization 

We used the same VSAM catalog TCPCAT defined in 6.1, “OC/FTP Server 
Installation” on page 61 for the OC/TELNET FS. 


10.1.2 Installation Procedures 

Installation of the product from tape to the product sublibrary involves the 
following steps: 

• Scan the product tape by submitting the job in Figure 35 on page 63 to 
VSE/ESA. 

• Use VSE/ESA II 'Install Product(s) from Tape' panel to generate the job to 
install the product into sublibrary TCPOCS.TNFS. 

The VSE/ES II panel also displays the minimum library space requirement for 
the product. 

• Submit the job to VSE/ESA to install the product. Our installation step took 
less than 10 minutes. 
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There is no installation verification job provided by the software. You may use 
the sample job in Figure 36 on page 64, te verify that the product is reccrded by 
MSHP. Testing of the product can only be performed after the product 
customization. Please refer to Chapter 22, “OC/TELNET FS Operation and 
Examples” on page 287 for the testing and operatien procedures. 


10.2 OC/TELNET FS Customization 

Customizaticn is based on the samples in PRODBILD.PROC provided by 
OC/TELNET FS. After the prcduct is installed in the product sublibrary, 
PRODBILD.PROC is punched into an ICCF library. We then edited it intc 
individual jobs to tailor the environment for OC/TELNET FS. 

The OC/TELNET FS customization consists of three steps: 

• VTAM custcmization 

• TELNET Client customizatien 

• Startup customization 


10.2.1 VTAM Customization 

The follcwing customization tasks are required in VTAM: 

• Logmode table and entries for the applicaticns and LUs 

• APPL definitions for the OC/TELNET FS 

• LU definitions for the OCS II Gateway LUs 

• USSTAB for VTAM logon to OC/TELNET FS 


10.2.1.1 Logmode Table OCSBIND 

The sample job listed in A.6, “OCSBIND MODETAB for OCS Products” on 
page 351 is used to create the OCSBIND logmode table. OC/TELNET FS uses 
the OCSLUO entry listed in Figure 86 for the OCS II Gateway LUs. 


OCSLUO MODEENT LOGiyDDE=OCSLUO, 

c 

TYPE=X<:00<: 

c 

EMPROF=X<:06<:, 

c 

TSPROF=X<:03<:, 

c 

PRIPROT=X<:00<:, 

c 

SECPROT=X<:00<:, 

c 

CCMPROT=X<:0000<:, 

c 

RnST7,E.S=XCFRFRC, 

PSERVIC=X<:000000000000000000000000<: 

c 


Figure 86. MODETAB Entry for OC/TELNET FS 
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10.2.1.2 VTAM APPL Definitions 

There are two types of APPL statement for OC/TELNET FS: 

• VSTELNET APPL statement for the OC/TELNET FS control application 

• VSNETnnn APPL statement, where nnn ranges from 001 to the maximum 
number of concurrent TELNET sessions 

Before we discuss the VTAM APPL definitions, it is important to understand how 
a VSE/ESA TELNET client establishes a session with the TCP/IP node using 
OC/TELNET FS. 

• When a VSE/ESA TELNET client wants to establish a connection to a TCP/IP 
TELNET server, the client logs on to VSTELNET from a VTAM terminal LU 

• VSTELNET dispatches the first available VSNETnnn application (for example 
VSNET001), and VSNETnnn is connected to the VTAM terminal with an LU-LU 
session 

• When the VSE/ESA TELNET client selects the OPEN option to connect to a 
TCP/IP node, an LU-LU session is established between VSNETnnn and the 
first available TELNET LU in OCS II Gateway 

• VSNETnnn passes the session request to OCS II Gateway, and a connection 
request is sent to the TCP/IP node 

• After the TCP/IP node accepts the OPEN request, the VSE/ESA TELNET client 
is requested to log in to the TCP/IP node 

• Once login is successful, the VTAM terminal emulates the TCP/IP node ASCII 
terminal 

Since VSTELNET is the OC/TELNET FS control program, an APPL entry must be 
defined to VTAM in the APPL major node. 

The number of VSNETnnn APPL entries depends on the number of concurrent 
VSE/ESA TELNET clients required. We defined 64 concurrent TELNET sessions 
using APPL entries VSNET001 to VSNET064 for our environment. The VSNETnnn 
application connects to the VTAM terminal LU and the OCS II Gateway LU at the 
same time during the TELNET session. The APPL definition must be able to 
support two concurrent sessions. 

Figure 87 is an extract from the complete VTAM APPL definition listed in A.4, 
“VTAM APPL Major Node for OCS Products” on page 344. 


VSTELNET APPL 
VSNETOOl APPL 
VSNET002 APPL 


AUTH=(ACQ,PASS),ACBNAME=VSTELNET 
AUTH=(ACQ),EAS=2,ACBNAME=VSNET001 
AUTH=(ACQ),EAS=2,ACBNAME=VSNET002 


VSNET064 APPL AUTH=(ACQ),EAS=2,ACBNAME=VSNET064 


Figure 87. APPL Definition Sample for OC/TELNET FS 


The key definitions and parameters are: 

• APPL entry for VSTELNET. The ACBNAME should be the same as the APPL 
label. It must also match the ACB name used in the SET MAJOR ACBNAME 
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command of the SYSIN file. For details ef the SYSIN file, please refer to 
10.2.2.4, “SYSIN File” on page 139. 

• VSNETnnn APPL entries. The number of VSNETnnn APPL entries depends 
on the number of concurrent TELNET sessions required and It should match 
the maximum number of users defined in the SYSIN file. The key 
parameters are: 

- ACBNAME. Should be the same as the APPL label. 

- The ACBNAME prefix VSNET. Must match the value specified In the SET 
MINOR ACBNAME command of the SYSIN file. 

- EAS=2. Allews two ooncurrent sessions. 


10.2.1.3 VTAM LU Definition 

The eempleted OCS II Gateway LUs definition is listed in Figure 24 on page 47, 
and A.3, “VSE TCPSW.B Switehed Major Node” on page 342. 

Figure 88 lists the LU definitions used by OC/TELNET FS. We defined three LUs 
for our test environment. To support the 64 sessiens defined in the APPL major 
node, 64 LUs should be defined. 


IPFT2S9J LU 

LOCADDR=10, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=OCSBIND, 

c 


iyDLTAB=VTMyDL, iyDLENT=VSELU2A, 

c 


PACING=1, VPACING=2, 

SSCPFI/T=USSSCS, USSTAB=VTMUSSTR 

c 

IPFT2S9K LU 

LOCADDR=ll, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=OCSBIND, 

c 


iyDLTAB=VTMyDL, iyDLENT=VSELU2A, 

c 


PACING=1, VPACING=2, 

SSCPFI/T=USSSCS, USSTAB=VTMUSSTR 

c 

IPFT2S9L LU 

LOCADDR=12, DLOGiyDD=OCSLUO, 

c 


ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

c 


iyDLTAB=VTiyMDL, MDLENT=VSELU2A, 

c 


PACING=1, VPACING=2, 

SSCPFiy^USSSCS, USSTAB=VTMUSSTR 

c 


Figure 88. Logical Unit Definitions for OC/TELNET FS 


The key parameters are: 

• The LU name. This must match: 

- The LU name in the OCS II Gateway customization 

- The LU name in the Netwerk LU List Member 

• LOCADDR. Must mateh the LU number in the OCS II Gateway customization. 

• MODETAB and DLOGMOD. Identify the appropriate legmode table entry. 

• PACING AND VPACING. Turn on VTAM pacing for the TELNET sessions. 
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10.2.1.4 VTAM USSTAB 

The VTAM USSTAB is modified to aiiow VSE/ESA users to iog on to VSTELNET 
from the VTAM iogon menu. Piease refer to A.5, “VTAM USSTAB” on page 345 
for the definitions. 


10.2.2 TELNET Client Customization 

This section covers the definitions required by the TELNET ciient function of 
OC/TELNET FS. Under VSE/ESA, each OC/TELNET ciient command fiie is an 
individuai subiibrary member in the OC/TELNET ciient subiibrary with a member 
type of 'TARMLIB". The defauit members provided by OC/TELNET may not 
appiy to your instailation. You should review and tailor the command files 
discussed in this section. If you need to do any changes to the defaults, you 
should punch the members membername.PARMLIB into your ICCF library using 
the LIBRP command. From the ICCF command line enter the following 
command: 

LIBRP TCPOCS.TNFS membername.PARMLIB membername. 

After yeu define a command file, you must catalog it into the OC/TELNET client 
sublibrary under the name: membername.PARMLIB, where membername is the 
name ef the command file. Catalog the changed members back using the 
following LIBRC command: 

LIBRC TCPOCS.TNFS membername.PARMLIB REPLACE. 

The follewing files are covered in this section: 

• NETWORKS. Defines IP network names and addresses. 

• NETWORKS LU List. Allocates LUs to the networks defined in the 
NETWORKS member. 

• HOSTS. Defines TCP/IP IP addresses and host names. 

• SYSIN. Defines system initializatien commands during system initialization. 

• DFLTSYS. Defines system default session commands. 

• DFLTUSR Defines user default session commands. 

• SYSCMDS. Defines the operator commands during system initialization. 

• Terminal Keyboard Profiles. Defines the terminal keyboard mapping profiles 
for the IBM 3278 emulatien. 

The commands in the SYSIN, DFLTSYS, DFLTUSR, SYSCMDS and Terminal 
Keyboard Profile files are documented in OpenConnect/TELNET Client Full 
Screen User and Administration Guide, 350-0145-101. 


10.2.2.1 NETWORKS File 

The NETWORKS and NETWORK LU List members are used to define to 
OC/TELNET FS, the: 

• IP network names and addresses 

• OCS II Gateway LU assignments for a specific network 
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The concept is the same as the network definition and LUs assignment 
discussed in 7.2.4.3, “NETWORKS Member” on page 95. 

Our definition is based on the network diagram in Figure 13 on page 34, and the 
IP address and name assignments in Table 3 on page 36. In the NETWORKS 
file, we defined the network IPFNET with IP network address 192.61.100. 

Figure 89 lists the job we used. "IPFNET" is the only network defined and the last 
line without an IP address defines It as the default network. 


CATALOG NETWORKS.PAHMLIB EOD=/+ 

REPLACE=YES 

# 


# SAMPLE NETWORKS FILE 


# 


IPFNET 192.61.100 


IPFNET 


/+ 



Figure 89. NETWORKS File for OC/TELNET FS 


10.2.2.2 NETWORKS LU List File IPFNET 

We used the IPFNET file to assign three LUs to the IPFNET network. The 
NETWORK LU List file name must correspond to the network name defined in the 
NETWORKS member. The LU names must correspond to the LU names defined 
for OCS II Gateway. We assigned LUs IPFT2S9J, K and L to the IPFNET network. 

Figure 90 lists the job we tailored. 


CATALOG IPFNET.PAHMILIB REPIACE=YES 

* SAMPLE GATEWAY 

■k 

GATEWAY BEGIN 
LU IPFT2S9J 
LU IPFT2S9K 
LU IPFT2S9L 
GATEWAY END 
/+ 


Figure 90. IPFNET LU List File for OC/TELNET FS 


10.2.2.3 HOSTS File 

This file is used to define the local and remote IP addresses and host names to 
OC/TELNET FS. With the specifications In this member, the VSE/ESA TELNET 
clients may use the host name to initiate a TELNET session to a TELNET server. 
The definitions in this file are based on the IP name and address assignments In 
Table 3 on page 36. 

Figure 91 on page 139 lists the job we used. 
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CATALOG HOSTS.PAR MTTR EOD=/+ REPIACE=YES 

# 

# SAMPLE HOSTS FILE 

# 

192.61.100.81 AIX320 
192.61.100.83 KWLOS2 
/+ 


Figure 91. HOSTS File for OC/TELNET FS 


10.2.2.4 SYSIN File 

This file contains initialization commands for starting OC/TELNET FS. Please 
refer to OpenConnect/TELNET Client Full Screen User and Administration Guide, 
350-0145-101 for details of system initialization commands. 

Figure 92 lists the job we used. 


CATALOG -SYSTN.PAR MTTR EOD=/+ REPLACE=YES 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* THE FOLLOWING SYSTEM INITIALIZATION COMMANDS ARE AUTOMATICALLY 

* EXECUTED WHEN THE PRODUCT IS STARTED. 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* SYSTEM INITIALIZATION COMMANDS FOR ALL OPERATING SYSTEMS: 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

:*r 

SET ACBNAME MAJOR VSTELNET 
SET ACBNAME MINOR VSNET 
SET ACBNAME START 1 
SET ACBNAME INQUIRE YES 

SET LUMAX 64 

:*r 

SET USERDATA OPTIONAL 

:*r 

SET USERMAX 64 

■k 

SET POOL SAS0020 START 
SET POOL SAS0020 COUNT 5 
SET POOL SAS0020 SIZE 20480 
SET POOL SAS0020 MODE ANY 
SET POOL SAS0020 END 


Figure 92. SYSIN File for OC/TELNET FS 

The key definitions and parameters are: 

• SET ACBNAME MAJOR command. Defines the major ACB name used by 
OC/TELNET FS. The ACB name must match the ACB name of VSTELNET 
defined in the VTAM APPL major node. 

• SET ACBNAME MINOR command. Defines the minor ACB name used by 
OC/TELNET FS. The value must match the name prefix of the VSNETnnn 
APPL entries defined in the VTAM APPL major node. 
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• SET ACBNAME START command. Determines the first avaiiabie VSNETnnn 
appiication to invoke. A vaiue of 1 causes VSNET001 as the first avaiiabie 
appiication to connect to a VSE/ESA TELNET ciient session. 

• SET ACBNAME INQUIRE YES command. Instructs OC/TELNET FS to inquire 
the active status of VSNETnnn, before aiiowing VSE/ESA TELNET ciients to 
iog on. 

• SET LUMAX command. Defines the maximum number of LUs aiiowed in the 
NETWORK LU List fiie(s). 

• SET USERDATA command. Determines whether a user command fiie must 
be provided, when the VSE/ESA TELNET ciients iog on to OC/TELNET FS. 

If SET USERDATA REOUIRED is specified, OC/TELNET FS terminates the 
iogon session when a user command fiie can not be found. The foilowing 
preparation tasks are required for this option: 

1. Create the user command fiie. Figure 93 iists the sampie we used. 

2. Modify the OC/TELNET FS USSTAB specification to inciude the command 
fiie name as user data, for exampie: 

USSPARM PARM = P2,REP = DATA,DEFAULT=USER 

If SET USERDATA OPTIONAL is specified, the user command fiie is not 
required for the OC/TELNET FS iogon. The VSE/ESA TELNET ciients may 
choose to specify a user command fiie with the VTAM LOGON command. For 
exampie, 

LOGON APPLiD(VSTELNET) DATA(USER) 

The first preparation task is required before this option can be used. 


CATALOG USER.PARMLIB EOD=/+ REPLACE=YES 
SET TERM DISC CONTINUE 
OPEN TCPGTWI 
TERMINAL 
QUIT 
/+ 


Figure 93. Sample User Command File 

• SET USERMAX command. Determines the maximum number of VSE/ESA 
TELNET clients required. 

• SET POOL command. Aiiow each instaliation to controi the number and size 
of storage aiiocated to a storage pooi in OC/TELNET ciient. 

• SET POOL START command. This must be the first command in a storage 
pooi definition for the pooi named SAS0020. 

• SET POOL COUNT command. Indicates the number of pooi entries 
OC/TELNET ciient shouid buiid for the named pooi. 

• SET POOL SIZE command. Indicates the size for each pooi entry. 

• SET POOL MODE command. Defines if the storage pooi shouid be above or 
beiow the 16MB iine. Specification of ANY aliows OC/TELNET ciient to buiid 
the pooi either above or beiow the 16MB iine. 

• SET POOL END command. This command must be the iast command in a 
storage pooi definition. 


140 TCP/IP for VSE/ESA 




— Note - 

We removed the SETTIMER LIMIT definition from SYSIN.PARMLIB as we 
received the error message: 

TA100I Set command parameter is invaiid during startup 
Set DECS NO is supported by MVS oniy and removed. 


10.2.2.5 DFLTSYS File 

This fiie contains session controi commands to determine how the OC/TELNET 
FS shouid be started. The commands in this fiie are executed during 
OC/TELNET FS initiaiization. This fiie may be used to set system defauit 
parameters to ease the operation of the VSE/ESA TELNET ciients. 

For detaiis of OC/TELNET FS session commands, piease refer to 
OpenConnect/TELNET Client Full Screen User and Administration Guide, 
350-0145-101. 

Figure 94 iists the job we used. 


CATALOG DFLTSYS.PAHMILIB E0D=/+ REPLACE=YES 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* THE SESSION CONTROL COMMANDS CONTAINED IN THIS MEMBER ARE 

* AUTOMATICALLY EXECUTED ON BEHALF OF EACH USER WHEN THEY LOGON. 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

SET KEYBOARD TERMTYPE YES 
/+ 


Figure 94. DFLTSYS File for OC/TELNET FS 


The definition is taken from PRODBILD.PROC, without modification. The SET 
KEYBOARD TERMTYPE command informs OC/TELNET FS to automaticaiiy 
execute a terminai keyboard profile whenever the terminal is reset. 


10.2.2.6 DFLTUSR File 

This file contains session control commands to determine how OC/TELNET FS 
sessions should be started for all VSE/ESA TELNET clients. 

This file is used to set up default session commands for the VSE/ESA TELNET 
clients. It may be used to automate the logon to a TELNET server. See 
Figure 95 for the sample we used. 


CATALOG DFLTUSR.PARMLIB EOD=/+ REPLACE=YES 

&USERDATA 

/+ 


Figure 95. DFLTUSR File for OC/TELNET FS 
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10.2.2.7 SYSCMDS File 

This file contains operator commands to be executed during OC/TELNET FS 
initialization. The file is taken from the PRODBILD.PROC without modification. 

For details of OC/TELNET FS operator commands, please refer to 
OpenConnect/TELNET Client Full Screen User and Administration Guide, 
350-0145-101. See Figure 96 for the sample we used. 


CATALOG SYSCMDS.PAHMILIB EOD=/+ REPIACE=YES 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* THE FOLLOWING SYSTEM OPERATOR COMMANDS ARE AUTOMATICALLY 

* EXECUTED WHEN THE PRODUCT IS STARTED: 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

SET QUERY COND 
/+ 


Figure 96. SYSCMDS File for OC/TELNET FS 


10.2.2.8 Terminal Keyboard Profiles 

The terminal keyboard profiles are used to define the IBM 3278 keyboard 
mapping. The following profile definitions are available as profilename.parmlib 
members: 

• D210 

• ESPRIT 

• EXPLORER 

• HP 

• IBM3161 

• LINE 

• MEAD 

• NATIVE 

• PAGE 

• SMIT 

• VAX 

• VIPROF 

• VT100 

• VT100A..E 

• VT200 

• VT52 

These terminal keyboard profiles may be used as samples to tailor terminal 
definitions not provided by OC/TELNET FS. 
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Please refer to OpenConnect/TELNET Client Full Screen User and Administration 
Guide, 350-0145-101 for the terminal keyboard profile descriptions. 




10.2.3 Startup Customization 

This step is to taiior the sampie OC/TELNET FS startup procedure from 
PRODBILD.PROC. 

Figure 97 iists the job we created. The foliowing changes are made: 

• Add the necessary JCL to start the job in a dynamic partition. 

• Specify the authorization code in the EXEC statement. The authorization 
code is obtained from OCS for license protection. It must be specified in the 
startup job. 


* $$ JOB JINIM=TNFS,CLASS=Y,DISP=L,NTFY=YES 

// JOB TNFS START OC/TELNET CLIENT FULL SCREEN 
// LOG 

// LIBDEF PHASE, SEARCH= (TCPOCS.TNFS, PRD2.CONFIG), TEMP 
// LIBDEF SOURCE,SEARCH= (TCPOCS.TNFS,PRD2.CONFIG),TEMP 
// EXEC PGiyh=TNFS,SIZE=TNFS,PARiy^<:E9B591767631<: 

/* 

/& 

* $$ EOJ 


Figure 97. OC/TELNET FS Startup Job 

Note: The OC/TELNET Software Authorization Code is specified as PARM=' ' 
on the EXEC statement of the OC/TELNET software startup procedure. 
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Chapter 11. OC/SAM Installation and Customization 

This chapter covers the installation and customization of OC/SAM. It consists of 
two steps: 

1. Installation - Describes the preparation and procedures to install OC/SAM in 
VSE/ESA 

2. Customization - Provides an explanation of the product customization. 

The installation instructions provided in this chapter assume you already have 
installed and are using the OCS II Gateway. OC/SAM is a program development 
toolkit that provides a socket application program interface on VSE/ESA systems 
to enable development of TCP/IP client/server applications. 


11.1 OC/SAM Installation 

There are three major steps involved to install the product: 

1. Prepare the installation environment for the product 

2. Restore the product from tape to the VSE/ESA sublibrary 

3. Verify the installation 

11.1.1 Installation Preparation 

To prepare for installation of the OC/SAM the following definitions are required: 

• An OCS II Gateway to VSE/ESA 

Please refer to Chapter 5, “Defining the OCS II Gateway to the Host” on 
page 41 for the setup instructions. 

• The VSE/ESA library and sublibraries for the product installation 

The definition of library TCPOCS is discussed in 6.1, “OC/FTP Server 
Installation” on page 61. 

The Librarian command LIBR DEF SUB is used to define the required 
sublibraries in library TCPOCS: 

Sublibrary used for 

SAMOBJ SAM object decks required to be linked into the application 
SAMMAC SAM assembler macros 
SAMSMP SAM sample programs 


11.1.2 Installation Procedures 

Installation of the product from tape to the product sublibrary involves the 
following steps: 

• To scan the tape before starting installation, use the following job, as 
illustrated in Figure 98 on page 146. 


© Copyright IBM Corp. 1995, 1996 
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* $$ JOB JNiy^LIBSCN,DISP=D,PRI=3, 

* $$ NTFY=YES, 

* $$ LDEST=*, 

* $$ CLASS=0 

// JOB LIBSCN SCAN VSE LIBRARY BACKUP TAPE 

* THIS FUNCTION USES A TAPE FOR INPUT 

* MOUNT LABELED TAPE WITH VOLUME ID=SOCKET ON DEVICE 180 

* THEN CONTINUE. IF NOT POSSIBLE CANCEL THIS JOB. 

// PAUSE 

// ASSGN SYS005,18I 

// TLBL TAPE1,CSOCK. TJB SC,,CSOCKFTC 

// EXEC LIBR,PARiy^<:MSHP<: 



RESTORE * 

/* 

LIBRARY IDENTIFICATION */ - 


ID = * 

/* 

MNEMONIC-ID OF THE */ - 



/* 

(SUB-) LIB ON TAPE*/ - 


SCAN = YES 

/* 

SCAN SPECIFICATION */ - 


TL = TAPEl 

/* 

Pointer to TLBL statement*/ 


TAPE = SYS005 

/* 

TAPEADDRESS */ 

/* 




// 

MTC RUN,I8I 



/& 





* $$ ECU 


C 

C 

C 


Figure 98. Sample Job to Scan Library Backup Tape 


• Use the II (Interactive Interface) 'Restore VSE Library from Tape' panel as 
illustrated below to generate the job to restore the three product libraries 
from tape, as shown in Figure 103 on page 148. 

• Submit the job to restore OC/SAM into subject sublibraries. 

First enter general restore parameters and the first sublibrary. 


SVR$LRS1 RESTORE VSE LIBRARY FROM TAPE 

Enter the required data and press ENTER. 

LIBRARY NAME.OCS_ Name of library to be restored. 

Use * for entire backup file. 

Press PF5 to finish the selection. 

SUBLIBRARY NAME.SOCKOBJ_ Enter name for subiibrary selection 

MEMBER NAME.. Enter name for member selection 

MEMBER TYPE.. Enter type for member selection 

Does the backup file have an identification (mnemonic-id) ? 

Use * to restore the complete tape. 

IDENTIFICATION.*_ _ 

NEWNAME.1 1 to restore under a new name, 

else 2 

TIME STAMP.1 1 to keep the old date, 

else 2 

LIST.1 1 for a listing, else 2 

OLD FORMAT.2 1 for libraries in old form, 

else 2 

PF1=HELP 2=REDISPLAY 3=END 5=PROCESS 


Figure 99. Restore VSE Library from Tape 
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Then specify the new name to be used. 


SVR$LRS2 RESTORE VSE LIBRARY FROM TAPE 

Enter the required data and press ENTER. 

Enter the new names you will use after RESTORE. 

At least one of these names must differ from those on the previous panel. 


LIBRARY NAME.TCPOCS Library name 

SUBLIBRARY NAME.SAMOBJ Sublibrary name 


PF1=HELP 2=REDISPLAY 3=END 

USE ONLY THOSE FIELDS WHICH HAVE ALREADY DATA IN IT. 

Figure 100. New Name Specification 

Repeat this for the other two subiibraries. Then enter the required data for the 
tape. 


SVR$TAPA RESTORE VSE LIBRARY FROM TAPE 

Enter the required data and press ENTER. 


TAPE ADDRESS. 181 Address of the input tape (cuu) 

For valid addresses enter a t?t 

VOLUME SERIAL NUMBER.SOCKET Volume serial number of the 

input tape. 

LABEL PROCESS. 1 Enter 1 if you want a labeled 

tape, otherwise enter 2. 


PF1=HELP 2=REDISPLAY 3=END 


Figure 101. Tape Information 

Enter the iast part of the tape information. 
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DSF$TAP1 


TAPE SPECIFICATION 


Enter the required data and press ENTER. 


LABEL CHECK 


1 


Enter 1 if you want label 
checking. Otherwise enter 2. 


TAPE FILE ID.SOCK.LIBS_ Unique name of the file on the 

volume. 


PF1=HELP 2=REDISPLAY 3=END 


Figure 102. Tape Specification 

This creates a job to restore the libraries from tape as shown in Figure 103. 


* $$ JOB JNiy^SAMRES,DISP=D,PRI=3, C 

* $$ NTFY=YES, C 

* $$ LDEST=*, C 

* $$ CLASS=0 

// JOB SAMRES RESTORE VSE LIBRARIES 

■k 

* THIS FUNCTION USES A TAPE FOR INPUT 

* MOUNT LABELED TAPE WITH VOLUME ID=SOCKET ON DEVICE 180 

* THEN CONTINUE. IF NOT POSSIBLE CANCEL THIS JOB. 

// PAUSE 

// TLBL TAPE!,CSOCK. TJB SC,,CSOCKFTC 
// ASSGN SYS004,181 
// EXEC LIBR,PARiy^<:MSHP<: 

RESTORE OCS. SOCKOBJ. *. *: TCPOCS. SAMOBJ 

/* MEMBER IDENTIFICATION */ - 
OCS.SOCKMACTCPOCS.SAMMAC 
OCS.SOCKSMPTCPOCS.SAMSMP 



ID = * 

/* MNEMONIC-ID OF THE */ - 

/* (SUB-) LIB ON TAPE*/ - 



LIST = YES 

/* LIST SPECIFICATION */ - 



REPLACE = YES 

/* REPLACE OPTION */ - 



DATE = OLD 

/* Indicator to keep timestairp 

*/ 


TL = TAPEl 

/* Pointer to TLBL statement 

*/ 


TAPE = SYS004 

/* TAPEADDRESS */ 


/* 




// MTC RUN, 181 



/& 





* $$ EOJ 


Figure 103. OC/SAM Library Restore Job 
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11.1.3 Installation Verification 


11.1.3.1 Installation Verification Job 

An installation verification job is provided with the sample material. The 
members used for installation verification in sublibrary TCPOCS.SAMSMP are: 

Member Description 

IVP.A Assembler source for verification program IVP 
$VSEJCL.A Job to assemble, link and run the test program 

To make the necessary changes to these members copy them into your ICCF 
library, enter the ICCF command line, switch to the proper ICCF library and copy 
the members from the product library into the ICCF library, as shown below: 


/SWITCH 96 

LIBRP TCPOCS.SAMSMP IVP.A IVPVSE 
LIBRP TCPOCS.SAMSMP $VSEJCL.A RUNIVP 


Figure 104. Copy Librarian Member into ICCF Library 


11.1.3.2 Modifications in IVPVSE 

The verification program is delivered in an MVS version. It has to be adapted to 
the VSE environment by changing a few lines as shown below. 

1. At label OPT01: replace 'MVS' with 'VSE' 

2. At label OPT51: replace the parameter library with your own, in our case 
'CL44'TCPOCS.FTPC" 

Catalog the changed ICCF member IVPVSE back to the product library using the 
following LIBRC ICCF procedure: 


LIBRC TCPOCS.SAMSMP IVP.A IVPVSE 
REMOVE 


Figure 105. Catalog ICCF Member into Sublibrary 


11.1.3.3 Modifications in RUNIVP 

To execute the verification program modify the RUNIVP member as shown 
below: 
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* $$ JOB JNiy^RUNIVP,CLASS=0,DISP=D 

* $$ LSI DISP=D,CLASS=A,DEST=(,WSTIEBER) 

// JOB RUNIVP RUN VERIFICATION PROGRAM IVP 
// LIBDEF SOURCE,SEARCH=TCPOCS.SAMMAC 
// LIBDEF OBJ,SEARCH=TCPOCS.SAMOBJ 
// LOG 

// OPTION LINK 

// EXEC PGiy^ASMA90, SIZE= (ASMA90, 50K), PARP^CSYSPARM(VSE) <: 

* $$ SLI MEM=IVP.A 
/* 

// EXEC PGM=LNKEDT 
/* 

// EXEC ,SIZE=AUTO 
/* 

/& 

* $$ EOJ 


Figure 106. Sample RUNIVP Job 


11.1.3.4 Run the Verification Program 

To assemble the source program we used the High Level Assembler. This 
sample program lets you generate the exit program 'EDECKXIT. 

Submit the RUNIVP job for execution. After the job finishes, check the listing to 
make sure that: 

1. The assembler completed without errors. 

2. The linkage editor included all required object decks into the phase. 

3. All trace events ended with return code 0, except for 'GET SERVICE BY 
NAME' for the service 'UNKNOWN'. 

4. The job ends with return code 4. 

Now OC/SAM has been correctly installed and the sockets interface is usable for 
your application programs. 


11.2 OC/SAM Customization 

No particular customization steps are required before OC/SAM can be used. 

An optional customization step for OC/SAM is: 

• 'GET SERVICE BY NAME' table customization 


11.2.1 GET SERVICE BY NAME Table Customization 

The 'GET SERVICE BY NAME' table contains the names of common service 
systems, such as FTP server, domain name servers and so on. If you want to 
define your own service system you have to add an entry to the 'GET SERVICE 
BY NAME' table. You do this by appending an entry to the source file 
TABLE001.A in sample sublibrary TCPOCS.SAMSMP. Then a new version of 
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TABLE001.0BJ has to be assembled and cataloged into the object subllbrary 
TCPOCS.SAMOBJ. 

These are the steps to add an entry to the 'GET SERVICE BY NAME' table: 

1. Copy TABLE001.A source file from TCPOCS.SAMSMP Into ICCF library 
member TABLE001 

2. Add new entries to ICCF member TABLE001 

3. Catalog the member you changed 

4. Run the assembly and use the $VSETABJ job to catalog the updated table 
Into the TCPOCS.SAMOBJ subllbrary 


11.2.1.1 Updating TABLE001 

If you want to define a new entry in the 'GET SERVICE BY NAME' table proceed 
as follows: 

Parameters Description 

MYSERVICE Is the name of a service system running somewhere In the network. 

50 Is the TCP/IP port number that MYSERVICE is using. 

UDP Is the TCP/IP transport protocol used by MYSERVICE. 

MINE Is an alias name that can also be used to locate MYSERVICE In the 
'GET SERVICE BY NAME' table. 

The resulting entry In the TABLE001 member appears as follows: 


DC 

CL20<:MYSERVICE<: 

Name of service 

DC 

HCSOC 

Port number service is using 

DC 

CL4<:UDP<: 

Protocol service is using 

DC 

CL20CMINE<: 

Alias name for service 


Figure 107. Add Entry to'GET SERVICE BY NAME Table 


11.2.1.2 Assemble and Catalog the GET SERVICE BY NAME Table 

Copy $VSETABJ Into ICCF member VSETABJ. Modify the job according to your 
requirements as shown in the example below: 

• Provide your VM user ID In the DEST parameter of the $$ LST statement 
('WSTIEBER' In the example). 

• Change the 'ACCESS SUBLIB' value to the subllbrary containing the object 
deck (we used TCPOCS.SAMOBJ). 

• Insert an End-of-Data marker ('/*') behind the Input cards of the first 
Invocation of the Assembler. 

Now the job to generate the new 'GET SERVICE BY NAME' table can be 
submitted. Figure 108 on page 152 lists the job we used. 
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* $$ JOB JNM=TABI£001,CIASS=0,DISP=D 

* $$ LSI DISP=D,CLASS=A,DEST={,WSTIEBER) 

* $$ PUN DISP=I,CLASS=0,PRI=9 

// JOB TABLEOOl CUSTOMIZE THE GET SERVICE BY NAME TABLE 
// LIBDEF SOURCE,SEARCH=TCPOCS.SAMSMP 
// LIBDEF PHASE,SEARCH=PRD2.PROD 
// LOG 

// OPTION DECK,NOXREF 

// EXEC Payi=ASMA90,SIZE=ASMA90 

PUNCH C* $$ LST DTSP=D, OT,ASS=A, DEST= (, WST TKR ER) C 
PUNCH <:* $$ PUN DISP=I,CLASS=0,PRI=9<: 

PUNCH <:// JOB TABLEOOIC 

PUNCH <:// LOGC 

PUNCH <:// EXEC PGM=LIBR<: 

PUNCH <: ACCESS ST JB T JR =TOPOCS. SAMOBJC 
PUNCH C CATALOG TABLEOOl .OBJ REPLACE=YES<: 

END 

/* 

// EXEC PGl>L=ASMA90,SIZE=ASMA90,PARiy^<:SYSPARM(VSE)<: 

* $$ SLI MEN^TABLEOOl.A 
/* 

// EXEC PGiyi=ASMA90,SIZE=ASMA90 
PUNCH <:/*<: 

PUNCH <:/&&<: 

END 

/* 

/& 

* $$ EOJ 


Figure 108. Sample VSETABJ Job 
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Chapter 12. OCS II Gateway Installation and Customization 


This chapter covers the OCS II Gateway part ef OpenConnect Systems running 
on a RISC/6000 and provides: 

• a functionai overview of the OCS il Gateway 

• detailed instructions on how to instali the OCS II Gateway 

• detailed instructions on how to customize the OCS II Gateway 

• special consideration on implementing OC/TELNET Server 

• set up alternative port number for AIX TELNET, FTP Servers 


12.1 OCS II Gateway Overview 

The OCS II Gateway provides gateway and protocol conversion functions as 
described in 3.1, “OCS II Gateway Functional Overview” on page 16. In this way 
a RISC/6000 workstation acts as a gateway between TCP/IP and SNA networks. 

The OCS II Gateway software resides en a RISC/6000 and cemmunicates to the 
VSE host ("upstream") via SNA protecels, while it cennects te TCP/IP nodes 
("downstream") using standard TCP/IP pretecols. 

As shown in Figure 2 on page 6, the OCS II Gateway part ef OpenConnect 
Systems consists of: 

• the base (called "OCS II"), which prcvides basic gateway functions such as 
mapping IP addresses to/from SNA LUs, conversion and translation of IP 
datagrams to/from SNA PIUs and so on. 

• the OC/TELNET Server (optional) which allows TCP/IP nodes to log on to the 
VSE host thereby emulating a 3270 type terminal. 

The other cemponents of OpenConnect Systems (OpenCennect/TELNET Client 
Full Screen and OpenConnect/File Transfer Pregram) reside in the VSE best. 
Refer te Chapter 3, “OCS Software Functional Overview” on page 15 for a 
description of these compenents. 


12.2 Preinstallation Tasks 

Chapter 2 of the OpenConnect Systems OpenConnect Server II Installations and 
Operations Guide RISC/6000, 350-0285-101.15 manual describes the 
pre-installation tasks in detail. Please refer te this decument which is delivered 
with the product diskette. This document only wants to point out that, before you 
begin the installation and customization process, you must understand your 
network configuration. The OCS II product offers a number ef services; (see 
Figure 2 on page 6); you may not require all of them, but yeu will have to 
identify them in order to understand the hardware and software requirements. In 
our installation the follewing OCS functions were defined and tested: 

• SNA gateway server (PU 2.0, LU 2 and Token-Ring Network) 

• 3270 Telnet Server (used by TCP/IP clients on PS/2, SUN and RISC/6000) 


© Copyright IBM Corp. 1995, 1996 
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12.3 Installation 


This is a very simple step: It basically consists of installing the base product 
diskette. Please refer to Chapter 3 of the OpenConnect Systems OpenConnect 
Server II Installations and Operations Guide RISC/6000, 350-0285-101.15 that 
describes the installation task in detail. The installation command sequence is 
the following: 

1. mkdir/usr/tmp/oc 

2. cd /usr/tmp/oc 

3. tar xvf Idevirdevname 

where rdevname = I/O device name (for example, rfdO for the diskette 
drive) 

4. ./ocinstall, to start the installation job 

Figure 109 shows the menu displayed when the installation exec (ocinstall) is 
invoked. 


OpenConnect Systems Incorporated 
CCS II Gateway Installation Procedure 

1) INSTALL or UPGRADE the CCS II Gateway Software 

2) VERIFY Checksums 

3) REMOVE the CCS II Gateway Software 

4) Get HELP for this Installation Procedure 

5) Sun-Specific Installation Procedure 

6) EXIT 


Copyright 1992. OpenConnect Systems Incorporated. 
2711 LBJ Freeway, Dallas, TX 75234 
Technical Assistance: (214) 888-0678 
Sales and Information: (214) 484-5200 

Enter selection number: 


Figure 109. Installation Exec Main Menu 

By choosing selection "I" the OCS II product code is loaded into the OCS 
directories. The contents of these directories after installation are shown in 
Figure 110 on page 155. This figure shows the OCC directories in addition to 
the OSC directories. 
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root@aix320: /usr/oc >ls 
INSTALL 
OCC.OCILOG 
OCC.OCINFO 
OCILOGP 
OCMSG 
OCSUM 
READ.ME 
bin 

config.list 
eps 

occinstall 
scr 

tn3179g 
/usr/oc/bin: 

..cone9164935 conf928.text 
ocsna peek 

sna_status status 

/usr/oc/config: 


-Rx /usr/oc 
INSTALL.OCC 
OCC.OCILOGP 
OCILOG 
OCINFO 
OCMSG.OCC 
OCSUM.OCC 
README.OCC 
config 
core 

OCC 

ocinstall 

sna 


libSEC.sl 

scad 


occonfig 

sna_start 


3030menu 

boxmenu 

cfdelgto 

chnconf 

cnos 

comitmnu 

configms 

dddlu 

delconf 

deletepu 

delgto 

devconf 

devconfg 

devmem 

devmenu 

dfltmnu 

dlcconf 

dlcdelcf 

dlcdelet 

dlcmenu 

dlcpunb 

dlctype 

dlinkall 

errexit 

exitconf 

filmenu 

filmenux 

gensys 

help 

hpbase 

hpconf 

hpdelcf 

hpdelet 

hpmenu 

hppurb 

hpsvcmnu 

hptokn 

hpx25 

hpx25pvc 

hpx25svc 

hpxadv 

hpxbasic 

hpxnetwk 

instconf 

instdel 

instdell 

instdel2 

instexit 

instldl 

instld2 

instldS 

instld4 

instldS 

instldcl 

instnewl 

instnew2 

instprtl 

instprt2 

instsvl 

instsv2 

instsv3 

ipbase 

ipinfo 

ipnets 

iprenfrm 

iprdacf 

iprdel 

iprdsef 

iprout 

iprout1 

keepaliv 

loadm2 

loadmenu 

luconf 

luinfo 

luinfol 

luinfo2 

luinfo3 

lumenu 

luusage 

mainmenu 

mrssinfo 

necsdlc 

ocs2menu 

printmnu 

puconfg 

rs6base 

rs6bsdlc 

rs6btokn 

rs6bx25 

rs6conf 

rs6delcf 

rs6delet 

rs6menu 

rs6punb 

rs6sdlc 

rs6tokn 

rs6x25 

rtminfo 

savdflt 

savebox 

savefil 

savefilx 

savem2 

scabase 

selchan 

seldev 

seldevg 

snaenfrm 

snaconfg 

snamenu 

snmpcoml 

snnpcomS 

snnpcom3 

snirpinfo 

soltokn 

sunbase 

sunconf 

sundelcf 

sundelet 

sunmenu 

sunpunb 

sunsdlc 

sysmenu 

tepinfo 

tepmenu 

telinfo 

telsec 

tn3270 

tn5250 

tntel 

toknmenu 

ts3270 

ts5250 

x25adv 

x25basic 

x25netwk 

x25pcomn 

x25scomn 

x25svc 





/usr/oc/config/help 







3030menu.hlp ... 

x25svc.help (Many help files but omitted) 



/usr/oc/eps: 

01 con 

eps eps. 

ocs_elinalert ocs. 
printcap rea 

/usr/oc/occ: 

OCINFO 

sea.ini 

/usr/oc/scr: 

pid starteps 

/usr/oc/sna: 

OCSNA.LOG.8090 

dlcfg.occl 

dlcfg.vm_via3174 

ocsvse 

pid 

sna_bin. vni_via3174 

status 

tn3270vse 

tsvse 


config 
eps_start 
ocs_elmd 
read.me 


config.save 
eps_status 
ocs_elmrpt 
tracutil 


defaults 

eps_stop 

ocs_elrnusage 


defaults.save 
ocs_elinadmin 
ocs elmver 


core 

sca.ini.org 
stadsca starttok 

core 

dlcfg.org 

etc 

parse 

sna.cfgsna.bin 

sna_cfg 

tmp 

tnf 

tvse 


Ifw util.s2 


Isca.s2 


dlcfg 
dlcfg.syn 
instance 
parseout 
sna_bin.occl 
start 

tn3179gvse 

trace 


Figure 110 (Part 1 of 2). OCS and OCC Directories Contents 
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ockeys 

options.vm_via3174 
Rx08290 


/usr/oc/sna/etc: 
cfgtext 
options.occl 
/usr/oc/sna/trap: 

Ex08290 
/usr/oc/sna/trace: 

/usr/oc/tn3179g: 

api cpsna Ibin man 

/usr/oc/tn3179g/api: 

Oc3270 Xapi3179g.a 

Oc3270 Xapi3179g.a 

api3270.a apidemo.c 

lu2io.h parmf ile 

thlulu.h 

/usr/oc/tn3179g/cpsna: 
printcap printers 

/usr/oc/tn3179g/Ibin: 
sna3270 tn3179g tn3270 

/usr/oc/tn3179g/man: 
manl mani 

/usr/oc/tn3179g/man/manl: 
sna3270.1 tn3179g.l 

/usr/oc/tn3179g/man/man4: 
snate 2 nnkey. 4 


octerracap 

tstext 


options 

tstextp 


■ cfg 
P 


read.rae 

Xapi3270.a 
Xapi3270.a 
corapile_apidemo 
scdefs.h 


api.h 

api.h 

iraplem.h 

scv.h 


snaterrakey 


snatennkey.org snatext 


vfyte 2 nTikey 


tn3270.1 


vfytermkey.1 


Figure 110 (Part 2 of 2). OCS and OCC Directories Contents 


12.4 Customization 

The customization of the OCS II Gateway is a more complex part. Various 
configuration files have to be modified according to your specific requirements. 
There are two different ways to do this: 

• Using the Configurator program ('occonfig'). 

• Manually editing the various files. 

It's strongly recommended to use the first method, since this is the easiest way 
to configure the OpenConnect Server II Gateway. It offers the advantage of a 
menu driven utility where you are asked to enter the values reflecting your real 
network configuration and your particular needs. The program Is able to do 
some checking of the values entered and to signal the possible errors. 

Starting with the configurator for Version 3.6 of the OCS II Gateway, the 
configuration process is designed to configure instances. An instance is one 
iteration of the OCSNA process running its specific configuration files. For more 
Information on the ocsna command, please see 13.1, “Operation Samples 
{start,stop,status....)” on page 189. Each Instance has Its own set of 
configuration files associated with it. Unique instances are maintained through 
the use of file name suffixes. 

The instance file Is created and maintained via the configurator. The contents of 
the file consist of the names of one or more instances and the associated file 
name suffix. A sample entry for an Instance file Is shown In Figure 111 on 
page 157. 
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INSTANCE_ENTRY: 
NAME = occl 
SUFFIX =01 
INSTANCE_ENTRY_END: 


Figure 111. Sample Entry for an Instance File 

The maximum number of OCSNA instances which can be configured is 16. If an 
instance name is present with no suffix, the configurator ioads and writes the 
defauit configurator fiies. Both the instance name and the suffix must be unique 
for each OCSNA instance. The defauit fiie name is /usr/oc/sna/instance. 

The different paneis described in Chapter 4 of the OpenConnect Systems 
OpenConnect Server II Installations and Operations Guide RISC/6000, 
350-0285-101.15 are sometimes difficuit to understand regarding the exact 
meaning of the vaiues requested. The foiiowing paragraphs describe the OCS II 
Gateway customization using the configuration program 'occonfig'; the "manuai" 
method wiii not be described. 

The configuration exec is calied occonfig and, if you accept the instaiiation 
defauits, resides in the directory /usr/oc/bin. To invoke it you have to enter the 
command occonfig (or ./occonfig if you have not made appropriate path 
definitions in your '.profiie'). 

Figure 112 on page 158 shows the Main menu that appears when the 
configuration exec is invoked. From this Main menu, you can seiect Select 
OCSNA Instance to Configure to update an existing configuration, or Load 
OCSNA Instance to create a new configuration. 

Piease see the OCS II Gateway Installation and Operations Guide, 350-0285-101 
for detailed information. Figure 113 on page 158 shows the screen after we 
seiect: Select OCSNA Instance to Configure. 
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CCS occonfig 

Main Menu 


Select OCSNA Instance to Configure 

Delete OCSNA Instance 

Generate OCSNA Instance Listing 

Load OCSNA Instance 

Save OCSNA Instance 


ESC+l=Help 

ESC+2=ExitPgm ESC+3=PrevMenu 

OCS II RISC/6000 V3.7.5 

ESC+4=ConfMenu 

ESC+5dMainMenu Return=AcceptMods 

Instance=occl 

Figure 112. Configuration Main Menu 

CCS occonfig 

Configure OCSNA Instance 


Enter an Instance Number to Configure. 

. . 2 

Instance 

Instance Instance 

Instance 

Number 

Name Number 

Name 

1 

occl 2 

vm_via3174 

3 

4 


5 

6 


7 

8 


9 

10 


11 

12 


13 

14 


15 

16 


Numeric values ONLY allowed in this field. 


ESC+l=Help 

ESC+2=ExitPgm ESC+3=PrevMenu 

OCS II RISC/6000 V3.7.5 

ESC+4=ConfMenu 

ESC+5dMainMenu Return=AcceptMods 

Instance=occl 


Figure 113. Configure OCSNA Instance Menu 


158 TCP/IP for VSE/ESA 






Warning 


During the configuration process, after having completed a screen and 
entered your appropriate values, press the ENTER key. If the values are 
correct you will receive the message: Input accepted. The parameters 
entered will become effective as soon as you save the configuration update 
(see following steps). 


CCS occonfig 


Instance Configuration Menu 


Local Area Network Configuration 
SNA Level Data Link Configuration 
Physical/Logical Unit Configuration 
System Wide Configuration Options 
Modify/View Data Link Configuration 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods 


CCS II RISC/6000 V3.7.5 
Instance=vm_via3174 


Figure 114. Instance Configuration Menu 

The individual configuration steps shown in the configuration menu will be 
discussed in the following sections. 
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12.4.1 Local Area Network (TCP/IP) Configuration 


CCS occonfig 


TCP/IP Configuration 


Specify Internet Addresses 
Specify TCP/IP Keepalive Options 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods 


OCS II RISC/6000 V3.7.5 
Instance=vm_via3174 


Figure 115. LAN Configuration Menu 

The LAN configuration is a required step to correctiy attach the OpenConnect 
Server li Gateway te the TCP/iP network. Severai parameters entered in these 
screens (Figure 116 en page 161 and Figure 118 on page 162) have to match 
the ones specified in the AIX TCP/iP setup. The customizatien setup and 
parameter vaiues shewn in the foliewing sections are taken from the actuai 
instaiiation at the ITSO Center Boebiingen. They refiect and correspond to the 
netwerk diagram shewn in Figure 13 on page 34. 
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CCS occonfig 


Specify Internet Addresses 


Internet address of the OCS II Server 


192.61.100.81 


NOTE - Addresses may be entered either in decimal notation or in 

hexadecimal. If entering hexadecimal addresses, precede them 
with OX. 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu OCS II RISC/6000 V3.7.5 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods Instance=vm_via3174 


Figure 116. Internet Address Configuration Menu 

• Internet address of the OpenConnect unit. This field represents the address 
assigned to your OCS II Gateway by the network administrator: It must match 
the Internet Address specified in 'TCP/IP Minimum Configuration and 
Startup' panel of the AIX System Management Interface Tool (SMIT) facility 
(Figure 117 on page 162). The ALTERNATE TOKEN RING address in SMIT's 
DEVICES part of 'System Management' has to match the MACADDR 
parameter in the VTAM PU statement of the switched major node definition 
(see Figure 31 on page 55). 

In order to find the SMIT TCP/IP Configuration Panel, you can specify SMIT at 
the AIX System prompt, this will give you the System Management Panel, 
here you have to select: Communications Applications and Services. On the 
next panel you have to specify TCP/IP, and on the following panel, specify: 
Minimum Configuration & Startup. On the next panel, please specify: 
Standard Ethernet Network Interface, and you should now be able to see the 
SMIT TCP/IP Configuration Panel, and to check the Internet Address. 

• Enable Keepalive Option. This option allows you to turn on or off the 
'Keepalive' option. The default setting is 'N' (off). This allows for sending 
Keepalive packets when there was no activity on the connection for the 
Keepalive interval set by AIX. For more information about the Keepalive 
interval, refer to the appropriate AIX documentation. 
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Minimum Configuration & Startup 

To Delete existing configuration data, please use Further Configuration menus 


Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 


* HOSTNAME 

* Internet ADDRESS (dotted decimal) 

Network MASK (dotted decimal) 

* Network INTERFACE 
NAMESERVER 

Internet ADDRESS (dotted decimal) 
DOMAIN Name 

Default GATEWAY Address 
(dotted decimal or symbolic name) 

RING Speed 
START Now 


Entry Fields 
aix320 

192.61.100.81 

255.255.255.0 

trO 

192.61.100.81 

itsc.ibm.com 

192.61.200.2 

16 

no 


Fl=Help 

Esc+5=Reset 

F9=Shell 


F2=Refresh 

F6=CoinTiand 

F10=Exit 


F3=Cancel 

F7=Edit 

Ente 20 =Do 


F4=List 

F8=Image 


+ 

+ 


Figure 117. SMIT TCP/IP Configuration Panel 


CCS occonfig 


Specify TCP/IP Keepalive Options 


Keepalive Option enabled(Y/N) 


Y N=Keepalive disabled (Default) 
Y=Keepalive enabled 


ESC+l=Help ESC+2=ExitPgm 

ESC+4=ConfMenu ESC+5=MainMenu 


ESC+3=PrevMenu 

Return=AcceptMods 


OCS II RISC/6000 V3.7.5 
Instance=vm_via3174 


Figure 118. TCP/IP Keepalive Option Menu 
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12.4.2 SNA Level Data Link Configuration 

Figure 119 is the first of a sequence of panels describing the SNA interface to 
the host, in our case an IBM 9221-150 running VSE/ESA. In order to provide the 
appropriate values, close cooperation with your SNA network administrator is 
required. 


CCS occonfig Data Link Values 

The values entered here will be in effect for ALL Physical Units defined. 

Datalink buffer size 2057 MUST match the MAXDATA parm in the NCP gen, 

or the MAXFRAME parm on the controller 
definition. 

NOTE - default value is 265. 

Datalink encoding NRZ Specify this parameter as either NRZ or NRZI. 

This parameter MUST match the corresponding 
entry in the host definition. 

NOTE - default value is NRZ. 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu OCS II RISC/6000 V3.7.5 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods Instance=vm_via3174 


Figure 119. SNA DLC Configuration Menu 

The fields appearing In the DLC configuration soreen describe the attributes 
common to all PUs (Physical Units) defined in the next section. 

• Datalink buffer size. This field specifies the maximum number of bytes that 
your physioal units can receive in one PIU, ineluding the transmission header 
(TH = 6 bytes) and the request/response header (RH = 3 bytes). It must 
match the value specified in the MAXDATA parameter of the PU VTAM or 
NCP statement (see Figure 31 on page 55). 

• Datalink encoding. This field describes the line encoding technique used on 
an SDLC link and must match the NRZI parameter of the LINE NCP 
statement. Although this entry isn't applicable to a Token-Ring line 
connection it's a required parameter and you have to specify it: The field will 
be Ignored. 
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12.4.3 Physical/Logical Unit Configuration 

These panels allow you to configure the characteristics of all 
workstations/terminals requiring access to VSE/ESA and vice versa via the OCS 
II Gateway controller. The number of configurable werkstatlons/terminals 
depends on the OpenConnect Server II Gateway feature you have Installed on 
your system (the base minimum feature contains 16 LUs). 


CCS occonfig 


PU/LU Configuration 


Work with Physical/Logical Unit Configuration 

Delete a Physical Unit, all its Logical Units and Datalink Entry 
Display Logical Unit Usage 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods 


OCS II RISC/6000 V3.7.5 
Instance=vm_via3174 


Figure 120. PU/LU Configuration Menu 

With the first option on this menu you are asked to introduce the relative 
Physical Unit number. This number is used to create an ordered list of the PUs 
defined and if it is your first PU definition, 1 (the default) has te be entered, since 
a discontinueus numeration isn't allowed. 
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CCS occonfig 


Physical Unit Definition 


PU name.IPFP2209 Will be used as the LOCAL LOCATION NAME for 

Midrange (S/36, S/38, AS/400) installations. 

Data Link Name.IPFP2209 Data Link Name is required. 

Station Address.... 04 MUST match the host definition. 

Termination Rule. . . T L = LUSTAT, T = TERM-SELF. 

PU type.PU2.0 Specify as either PU2.0 or PU2.1. 

IDBLK value.017 Defines capabilities the PU provides. 

tOOOt or t t will default to 0x017 for 
PU2.0 or 0x03E for PU2.1. 

IDNUM value.E0009 MUST match the IDNUM pam in host definition, 

if specified. 

PU connected to a N Enter Y if this PU is to be DIRECTLY CONNECTED 

Midrange system? to a MIDRANGE (S/36, S/38, AS/400) system, or 

N if this PU is to be DIRECTLY CONNECTED to a 
MAINFRAME class system. 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu OCS II RISC/6000 V3.7.5 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods Instance=vm_via3174 


Figure 121. Physical Unit Configuration 


• PU name. It describes the network node name assigned to this PU and must 
match the label name of the PU statement of your VTAM or NCP definition 
(see Figure 24 on page 47 and Figure 31 on page 55). 

• Data Link Name. 

• Station address. This field contains the two digit number assigned to this PU. 
For an SDLC link it must match the ADDR parameter value ef the PU 
VTAM/NCP statement. For a Token-Ring connection it must match the 
Service Access Point (SAP) of OCS II Gateway station (for a RISC/6000 it's 
always 4). 

• Termination Rule.Jhe recommended setting for S/370 is 'T which makes 
sure that VTAM is notified at session termination. For 3274 controllers, the 
recommended setting is 'L' which lets the applicatien contrel the session 
termination. 

• PU type. The only two values accepted in this field are PU2.0 and PU2.1. The 
PU2.0 identifies a standard SNA cluster (fer example, 3274) working in the 
classic SNA hierarchical mode. The PU2.1 defines the new type of cluster 
contrellers (for example, 3174) or midrange systems (for example, AS/400) 
supporting the APPN (Advanced Peer-to-Peer Networking) functions. For 
more details on this please refer to VTAM Network Implementation Guide, 
SCSI-6434. 

• IDNUM value. This field is a user value and must match the IDNUM 
parameter ef the PU statement in the VTAM Switched major node definition. 
If you have configured the Gateway station as a local major node, you can 
insert any mnemonic value (for example, PU001). 
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• Midrange connection. If your OCS II Gateway station is connected to a 
midrange system (for exampie AS/400) specify Y. in our case (mainframe 
connection) we specified N. 

After pressing ENTER the next screen (Figure 122) appears. 

Seiect Display all Logical Units and the next screen (Figure 123 on page 167) 
appears. 


CCS occonfig 


Logical Unit Menu 


Configure Logical Units 
Display All Logical Units 
Configure Datalink 
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Figure 122. Logical Unit Configuration 
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CCS occonfig Display All Logical Units 

To configure LU<:s, enter the LU name and LU type. See Help for LU types. 



LU Name 

Type 


LU Name 

Type 


LU Name 

Type 


LU Name 

Type 

1) 

IPFT2S9A 

14 

2) 

IPFT2S9B 

14 

3) 

IPFT2S9C 

14 

4) 

IPFT2S9D 

14 

5) 

IPFT2S9E 

14 

6) 

IPFT2S9F 

14 

7) 

IPFT2S9G 

14 

8) 

IPFT2S9H 

14 

9) 

IPFT2S9I 

14 

10) 

IPFT2S9J 

14 

11) 

IPFT2S9K 

14 

12) 

IPFT2S9L 

14 

13) 

IPFT2S9M 

10 

14) 

IPFT2S9N 

1 

15) 

IPFT2S90 

1 

16) 

IPFT2S9P 

14 

17) 



18) 



19) 



20) 



21) 



22) 



23) 



24) 



25) 



26) 



27) 



28) 



29) 



30) 



31) 



32) 



33) 



34) 



35) 



36) 



37) 



38) 



39) 



40) 



41) 



42) 



43) 



44) 



45) 



46) 



47) 



48) 



49) 



50) 



51) 



52) 



53) 



54) 



55) 



56) 



57) 



58) 



59) 



60) 



61) 



62) 



63) 



64) 
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Figure 123. Logical Unit Configuration 

In this configuration panei you are asked to introduce the vaiues describing the 
LU characteristics owned by the PU you just configured. Yeu can define up to 64 
LUs for each PU. 

• LU name. This fieid contains the symboiic name representing this LU in yeur 
network. The LU name and its corresponding number must match, in the 
same order, the iabei name and the LOCADDR parameter in the VTAM/NCP 
LU statement (see A.3, “VSE TCPSW.B Switched Major Node” on page 342). 

• LU type. This fieid requires a number whese vaiue is shown in the upper 
side of this screen. When specifying the number censider how the 
workstation assigned te it wiii be used. Specify: 

- "14" fcr LUs interfacing the OCS II products: 

- OpenConnect/File Transfer Pregram Client 

- OpenCennect/Remote Sheii (remote sheii) 

- OpenConnect/Fiie Transfer Program Server 

- OpenConnect/TELNET Ciient Fuil Screen 

- OpenConnect/Line Printer Daemon 

- and aiso for Socket Access Method Appiication programs 

- "1, 5, 6, 7, 8" for LUs assigned to the OCS II Telnet Server function of the 
OCS II Gateway 

- "10" fer LU assigned to a terminal printer LU 3 (3287 LU 3). 

- "15, 16" for APPC (not used in our installation). 
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12.4.4 System Wide Configuration Options 

In this menu you have the chance to customize or enabie some services of the 
OCS li Gateway Software. This is an optionai step; if you don't perform it the 
system uses the defauit vaiues. 

The menu shown in Figure 124 provides for the customization of severai 
services of the OCS li Gateway. The reievant services for our environment are: 

• Misceiianeous System Wide Parameters 

• TN and TELNET Server Configuration 

• PU T2.1 Node Configuration 


OCS occonfig 


System Inforsnation 


Miscellaneous System Wide Parameters 

Dynamic Definition of Dependent LU (DDDLU) Configuration 
Response Time Monitor (RTM) Configuration 
TN and Telnet Server Configuration 
PU T2.1 Node Configuration 

Midrange FTP Server Support (MRSS) Configuration 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods 


OCS II RISC/6000 V3.7.5 
Instance=vm_via3174 


Figure 124. System Wide Options Configuration Menu 

When you seiect Miscellaneous System Wide Parameters you wili see the 
foiiowing screen: 
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CCS occonfig 


Miscellaneous System Wide Parameters 


Instance Administration Port Number.(Default is 2000) . 2000 


Suppress BASIC ALERTS.N 

Keyboard reset on program check.Y 

Assign only an active dependent LU.N 

AYT interval for 3270 sessions and APPC applications.100 


Valid values are from 100 to 300 seconds. A value of 0 
indicates that NO tAre you there! messages will be sent. 
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Figure 125. Miscellaneous System Wide Parameters 

• Instance Administration Port Number, defines the TCP port to enable 
connections with OCS admin utilities. The default is 2000. 

• Suppress BASIC ALERTS option controls sending alerts to IBM's NETVIEW. 
The default value is N. 

• Keyboard reset on program check, option controls the keyboard operation 
when a negative response is received containing an end bracket. The 
default value is Y. 

• Assign only an active dependent LU option controls the requests to obtain an 
LU when there is no SSCP-LU session active. The default value is N. 

• "Are you there" polling interval for 3270 sessions and APPC applications can 
range from 100 to 300 seconds. If no polling is desired, set value to 0. 
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CCS occonfig 


TN and Telnet Se2rver Configuration 


Telnet Se 2 rver Configuration 
TN 3270 Configuration 
TN 5250 Configuration 
Telnet 3270 Configuration 
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Figure 126. TN and TELNET Server Configuration 

In our installation we changed the default values from 

• Telnet Server Configuration and 

• TN 3270 Configuration 
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CCS occonfig 


TELNET Se2:ver Configuration 


Do you want Telnet Server to use negotiated TERM types?. .. . N 
If desired, enter an alternate port number for Telnet Srvr 23 
Enter size (1-128KB) of the Temcap RAMDISK(64KB default) . . 64 

Enter the number of TELNET Redirector sessions.16 

Response time interval in seconds for IP Address 

Health Check feature (0 = disable). 0 

Response time interval in seconds for Requested LU 

Health Check feature (0 = disable). 0 

Queue session activation requests until Health Check 

completes? (Requested LU Health Check is required).N 

Do you want to log sessions te 2 mrLnated by Health Check?. .. . N 
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Figure 127. TELNET Server Configuration 

• Term types negotiation. You can enable the OCS II Telnet Server to 
negotiate, with the remete host, the terminal type. 

• Alternate PORT number. This field is a feur digit number defining the port 
number reserved for Telnet sessions with the VSE/ESA host. It must be 
different from the AIX TELNET Server port number. Refer to 12.6, “Set up 
Alternative Perts fer AIX TELNET and FTP Servers” on page 186 for 
assigning an alternate pert for AIX TELNET Server. 

• Termcap file size. This field Is the maximum size. In Kbytes, of the 
'octermcap' file that contains the display station's definition (please refer to 
OCS II Telnet Server Manager, 350-0193-101 for details). 

• TELNET Redirector Sessions. Defaults to the current configuration In the 
option file. If not currently defined In the Option File, it will default to the 
number of LUs purchased. Disable = 0. 

NOTE - TELNET Redirector Option may not be available on all platforms. 
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CCS occonfig TN 3270 Se 2 rver Configuration 


Enter the number of TN3270 sessions.8 

Enable TN3270E support?.N 

TN3270E Functions 

Enable SCS-CTL-CODES function support?.Y 

Enable DATA-STREftM-CTL function support?.Y 

Enable RESPONSES function support?.Y 

Enable BIND-IMAGE function support?.Y 

Enable SYSREQ function support?.Y 
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Figure 128. TN 3270 Server Configuration 

• Number of TN3270 sessions. Determines the number of concurrent Telnet 
3270 sessions you want to support. The maximum value depends on the 
number of sessions you have purchased. 

• Enable TN3270E Support. Allows the user to enable/disable support for RFC 
1647 in the OC/Telnet Server. The default is disabled. 

• TN3270E Function Support. If TN3270E support is enabled, the user may 
enable/disable individual TN3270E functions. The default is ALL enabled. 

• SCS-CTL-CODES function. Required for SCS (LU type 1) Print sessions 

• DATA-STREAM-CTL function. Required for 3270 Data Stream (LU type 3) 
Print sessions. 

• RESPONSES function. Provides support for definite, exception and no 
response requests. 

• BIND-IMAGE function. Forwards BIND/UNBIND notifications to client. 

• SYSREQ function. Function emulates the SYSREQ key in an SNA 
environment. 
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CCS occonfig Telnet 3270 Server Configuration 

Enter the number of 3270 Telnet Server sessions. 16 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 
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OCS II RISC/6000 V3.7.5 
Instance=vm_via3174 


Figure 129. TELNET 3270 Server Configuration 

• Number of 3270 Telnet Server sessions. Determines the maximum number of 
aliowabie requests to the Teinet Server for a 3270 emuiation. This number 
depends on the OCS II Gateway Software you have purchased. 


CCS occonfig PU T2.1 Node Configuration 


Enter the Network Identifier for this unit.DEIBMIPF 

Session increment for CNOS source negotiator.8 

Number of above sessions that are tsource winners!.4 

Gateway initiated sessions select source losers?.Y 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods 
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Instance=vm_via3174 


Figure 130. PU T2.1 Node Configuration 
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• Network Identifier. Network Identifier defines the SNA NETID associated with 
OCS Server. This field requires an eight character symbolic name 
identifying your network name; it must match the NETID parameter in the 
ATCSTRxx VTAM startup member (see A.2, “VSE VTAM Start Options List” 
on page 341). 

• Keep the defaults of CNOS source negotiator and number of sessions. They 
do not apply to our configuration. 


12.4.5 OCS II RISC/6000 Data Link Configuration 

This is the last configuration menu. Here you must describe the physical data 
link characteristics of your RISC/6000. Presently the OCS II Gateway supports 
the SDLC and Token-Ring interfaces; in our installation we have configured and 
tested the Token-Ring interface. 


OCS occonfig 


Instance Configuration Menu 


Local Area Network Configuration 
SNA Level Data Link Configuration 
Physical/Logical Unit Configuration 
System Wide Configuration Options 
Modify/View Data Link Configuration 
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Figure 131. Instance Configuration Menu 

With the fifth option on the Instance Configuration Menu you select: Modify/View 
Data Link Configuration. You are then asked to introduce the relative Link 
Station (LS) number. This number is used to create an ordered list of the LSs 
and if it is your first LS definition, 1 (the default) has to be entered, since 
non-continuous numbering is not allowed. 
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CCS occonfig 


Link Configuration 


Link Station Type. 


Valid values - SDLC, TORN, X.25 or SCA. 
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Figure 132. RISC/6000 Link Configuration 


CCS occonfig 


Token Ring Data Link Configuration 


Adapter Name.tokO 

Call Type.C 

Drop Link on Inact? (Y/N) . . . N 

Receive Window. 1 

Transmit Window.7 

Retransmit Count.8 

Retransmit timeout. 14 


Inactivity timeout.48 

Force Disconnect Timeout... 120 


DLC Buffer Size. 2057 

Link Name.IPFP2209 


Adapter name for this station 
C=Call out, L=Listen for call 
Y=Drop Link on Inact 
Receive Window size 
Transmit Window size 
Number (1-50) of xmit retries 
Number (1-250) of (.5 sec) intervals 
to wait before retransmitting 
an unacknowledged I-frame. 

Idle Line timeout value (1-120 secs) 
Number (1-600) of seconds to wait for 
disconnect response before forcing 
the link disconnect 
Datalink buffer size 
Link name for this DLC entry 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 
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OCS II RISC/6000 V3.7.5 
Instance=vm via3174 


Figure 133. RISC/6000 Token Ring Data Link Configuration 
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In Figure 133 and Figure 135 on page 178 you describe the Link Configuration 
parameters. They are presented in a different order than their actuai 
appearance for the sake of easier understanding. 

Link Station parameters. The foilowing parameters specify the physicai iink 
configuration of your RISC/6000. 

• Link Station type. This fieid has oniy two possibie vaiues: 

- SDLC = SDLC data iink oontroi 

- TOKN = Token-Ring data iink oontroi 

• Adapter name. This name must match the adapter name specified in the 
Token-Ring adapter configuration panei of the AIX SMIT faciiity (Figure 135 
on page 178). 

In order to find the SMiT Change/Show Charaoteristios of a Token Ring 
Adapter, you can specify SMIT at the AIX System prompt, this wiil give you 
the System Management Panei, here you have to seieot: Devices, then on 
the next panei: Communication, foiiowed by: Token Ring Adapter. On the 
next panei you have to specify Adapter, and on the foiiowing panei, specify: 
Change/Show Characteristics of a Token Ring Adapter, and you shouid now 
be abie to see the Change/Show Charaoteristios of a Token Ring Adapter, 
and to find the Adapter Name. 

• Caii type. This fieid indicates the cali procedure for the oonnection to the 
host. Specify: 

- L = the RISC/6000 station waits for the host activation to make the data 
iink connection with it. In this case it is necessary to specify a PATH 
statement in the VTAM Switched major node (see A.3, “VSE TCPSW.B 
Switched Major Node” on page 342). 

- C = the RISC/6000 station initiates a data iink connection by cailing the 
host. We specify 'C' because a remote iink address is specified in 
Figure 134 on page 177. 

• Remote SAP Address. This fieid specifies the SAP Address of the VSE host 
and must match the SAPADDR parameter of the PORT statement in the 
VTAM LAN major node (see Figure 30 on page 53). 

• Remote Link Address. This fieid contains the Token-Ring adapter address of 
the VSE host and must match the MACADDR parameter of the PORT 
statement in the VTAM LAN major node (see Figure 30 on page 53). 

Network tuning. The foliowing parameters infiuenoe the throughput rate, so you 
have to speoify them with oare considering oompromises between network 
reiiabiiity and throughput effioiency. 

• Drop iink inact. This question asks if you want to disoonneot the iink with the 
remote host when the RISC/6000 doesn't receive any data on the iink for a 
specified period of time. This period is caicuiated from the vaiues from the 
Inactivity timeout, Retransmit count and Retransmit timeout keywords. 

• Receive window. This fieid oontains the maximum number of frames to 
receive from the host before sending an aoknowiedgment. 

• Transmit window. This fieid contains the maximum number of frames to send 
to the host before receiving an acknowiedgment. 

• Retransmit count. This fieid specifies the maximum number of retries to 
retransmit the same frame when a transmission error ocours. 
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• Retransmit timeout. This field specifies the maximum peried of time (for 
Token-Ring it is measured in 0.5 second intervals) that the RISC/6000 waits 
for a response from the host before retransmitting the same frame. 

• Inactivity timeout. This field represents the number ef seconds that the 
RISC/6000 waits for a data transmission from the host. 

• Force disconnect timeout. This field specifies the number of seconds that the 
RISC/6000 waits after requesting a discennection from the link, before the 
system forces the disconnectien. 

• Acknowledge Timeout. This field specifies the maximum period of time (for 
Teken-Ring it is measured in 0.5 second intervals) that the RISC/6000 waits 
before sending an acknewledgment to the host. 

• Dynamic Window. This field specifies the number of consecutive 
acknowledged frames frem the host before the RISC/6000 can increase its 
transmit window. 


CCS occonfig 


Token Ring Configuration 


Remote Sap Address. ... 04 

Remote Link. 0X400020201001 

Acknowledge Timeout... 1 


SAP address of the gatewayCs 
partner. 

Token Ring address of the 
gatewayCs partner. 

Number (1-40) of .5 sec intervals 
before acknowledgement is sent. 


NOTE - See Help for default values. 
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Figure 134. Token-Ring Configuration 
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Minimum Configuration & Startup 


To Delete existing configuration data, please use Further Configuration menus 


Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 


* HOSTNAME 

* Internet ADDRESS (dotted decimal) 
Network MASK (dotted decimal) 

* Network INTERFACE 

NAMESERVER 


Entry Fields 
aix320 

192.61.100.81 

255.255.255.0 

trO 


Internet ADDRESS (dotted decimal) 

DOMAIN Name 

Default GATEWAY Address 
(dotted decimal or symbolic name) 

192.61.100.81 

itsc.ibm.com 

192.61.200.2 


RING Speed 


16 

+ 

START Now 


no 

+ 

ALTERNATE TOKEN RING address 


0x400010101009 

+ 

Apply change to DATABASE only 

BOTTOM 


no 

+ 

Fl=Help F2=Refresh 

F3=Cancel 

F4=List 


Esc+5=Reset F6=CoinTiand 

F9=Shell F10=Exit 

F7=Edit 

Ente 2 o=Do 

F8=Image 



Figure 135. AIX SMIT Token-Ring Adapter Configuration Panel 


12.4.6 Generate a Configuration Listing 

Choosing this option generates a flat file containing all your definitions of the 
OCS II Gateway of the instance file selected. The information is formatted in a 
user friendly way which makes it very easy to check all parameters. Here's the 
list of our OCS II configuration: 
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★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 


* Instance File 

* FilenaiTB : /usr/oc/sna/instance 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

INSTANCE_EISITRY: 

NAME = occl 
SUFFIX = occl 
INSTANCE_ENTRY_END: 

INSTANCE_ENTRY: 

NAME = vm_via3174 
SUFFIX = vm_via3174 
INSTANCE_ENTRY_END: 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* Feature Manager Keys 

* Filename : /usr/oc/sna/etc/ockeys 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

6bxlu-h31hp-zkkkk- j zmklumlqge-S z zx3-qk.8ta 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

* SNA Configuration for Instance vm_via3174 

* Filename : /usr/oc/sna/sna_bin.vm_via3174 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

The total number of control units in this configuration is 1. 

Internet address: 192.61.100.81 Gateway Address: 192.61.100.83 

Data Link encoding technique: NRZ Data Link Buffer Size: 2048 

Control Unit Information for relative CU nnrnber 1: 

Unit type: 3274 Controller Name: IPFP2209 XID: 2017E0009 
Physical Unit type: PU2.0 Logical Unit Termination Rule: Terminate Self. 
Host type: MAINFRAME Data Link Role: SECONDARY Station Address: 4 
Link Name: IPFP2209 

Logical Unit Configuration: 

Highest Logical Unit configured is 16. 

LU: 1 Name: IPFT2S9A Type: Display Model: TCP/IP 

LU: 2 Name: IPFT2S9B Type: Display Model: TCP/IP 

LU: 3 Name: IPFT2S9C Type: Display Model: TCP/IP 

LU: 4 Name: IPFT2S9D Type: Display Model: TCP/IP 

LU: 5 Name: IPFT2S9E Type: Display Model: TCP/IP 

LU: 6 Name: IPFT2S9F Type: Display Model: TCP/IP 

LU: 7 Name: IPFT2S9G Type: Display Model: TCP/IP 

LU: 8 Name: IPFT2S9H Type: Display Model: TCP/IP 

LU: 9 Name: IPFT2S9I Type: Display Model: TCP/IP 

LU: 10 Name: IPFT2S9J Type: Display Model: TCP/IP 

LU: II Name: IPFT2S9K Type: Display Model: TCP/IP 

LU: 12 Name: IPFT2S9L Type: Display Model: TCP/IP 

LU: 13 Name: IPFT2S9M Type: Printer Model: 3287 — DSC 

LU: 14 Name: IPFT2S9N Type: Display Model: 3278 Model 2 

LU: 15 Name: IPFT2S90 Type: Display Model: 3278 Model 2 

LU: 16 Name: IPFT2S9P Type: Display Model: TCP/IP 

Figure 136 (Part 1 of 2). Configuration Listing 
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★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* OPTIONS Configuration for Instance vin_via3174 

* Filename : /usr/oc/sna/etc/options.vm_via3174 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

KEEPALIVE = Y 

PS_PORT # 2000 

SUPPRESS_ALERTS = N 

KEYBOARD_RESET_ON_PROG_CHECK = Y 

ASSIGN_ONLY_ACTIVE_LU = N 

AYT_INTERVAL # 100 

USERS_TN3270 # 8 

NETID = DEIBMIPF 

NUMSESS # 8 

SRCWIN # 4 

NEGTERM = N 

TSPORT # 23 

TERMOAP_RAMDISK_SIZE # 65536 

USERS_TSPASS # 16 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* Data Link Configuration for Instance vm_via3174 

* Filename : /usr/oc/sna/dlcfg.vm_via3174 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 


TR_DLC_ENTRY ; 



ADAPTER 

= 

tokO 

CALLJTYPE 

= 

C 

RECEIVE_WINDOW 

# 

1 

TRANSMIT_WINDCW 

# 

7 

DROP_LINK_ON_INACT 

= 

N 

INACTIVITYJTIMEOUT 

# 

48 

RETRANSMIT_COUNT 

# 

8 

RETRANSMITJTIMEOUT 

# 

14 

FORCEJDISCJTIMEOUT 

# 

120 

REM3TE_SAP_ADDR 


# 0X04 

REiyDTE_LINK_ADDR 

= 

0X400020201001 

ACKNOWLEDGEJTIMEOUT 


# 1 

dlc_buf_size 

# 

2057 

LINK_NAME 

= 

IPFP2209 

dlc_entry_end 




Figure 136 (Part 2 of 2). Configuration Listing 
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★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 


* Instance File 

* FilenaiTB : /usr/oc/sna/instance 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

INSTANCE_EISITRY: 

NAME = occl 
SUFFIX = occl 
INSTANCE_ENTRY_END: 

INSTANCE_ENTRY: 

NAME = vm_via3174 
SUFFIX = vm_via3174 
INSTANCE_ENTRY_END: 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* Feature Manager Keys 

* Filename : /usr/oc/sna/etc/ockeys 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

6bxlu-h31hp-zkkkk- j zmklumlqge-S z zx3-qk.8ta 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

* SNA Configuration for Instance occl 

* Filename : /usr/oc/sna/sna_bin.occl 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

The total number of control units in this configuration is 1. 

Internet address: 192.61.100.81 Gateway Address: 192.61.100.83 
Data Link encoding technique: NRZ Data Link Buffer Size: 256 

Control Unit Information for relative CU nrimber 1: 

Unit type: 3274 Controller Name: IPFP2901 XID: 201700000 
Physical Unit type: PU2.0 Logical Unit Termination Rule: Terminate Self. 
Host type: MAINFRAME Data Link Role: SECONDARY Station Address: 1 
Link Name: IPFP2901 

Logical Unit Configuration: 

Highest Logical Unit configured is 16. 

LU: 1 Name: IPFT2S9A Type: Display Model: TCP/IP 

LU: 2 Name: IPFT2S9B Type: Display Model: TCP/IP 

LU: 3 Name: IPFT2S9C Type: Display Model: TCP/IP 

LU: 4 Name: IPFT2S9D Type: Display Model: TCP/IP 

LU: 5 Name: IPFT2S9E Type: Display Model: TCP/IP 

LU: 6 Name: IPFT2S9F Type: Display Model: TCP/IP 

LU: 7 Name: IPFT2S9G Type: Display Model: TCP/IP 

LU: 8 Name: IPFT2S9H Type: Display Model: TCP/IP 

LU: 9 Name: IPFT2S9I Type: Display Model: TCP/IP 

LU: 10 Name: IPFT2S9J Type: Display Model: TCP/IP 

LU: II Name: IPFT2S9K Type: Display Model: TCP/IP 

LU: 12 Name: IPFT2S9L Type: Display Model: TCP/IP 

LU: 13 Name: IPFT2S9M Type: Printer Model: 3287 — DSC 

LU: 14 Name: IPFT2S9N Type: Display Model: 3278 Model 2 

LU: 15 Name: IPFT2S90 Type: Display Model: 3278 Model 2 

LU: 16 Name: IPFT2S9P Type: Display Model: TCP/IP 

Figure 137 (Part 1 of 2). OCC Configuration Listing 
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★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* OPTIONS Configuration for Instance occl 

* Filename : /usr/oc/sna/etc/options.occl 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

KEEPALIVE = Y 

PS_PORT # 2001 

SUPPRESS_ALERTS = N 
KEYBOARD_RESET_ON_PROG_CHECK = Y 
ASSIGN_ONLY_ACTIVE_LU = N 
AYT_INTERVAL # 100 

UNSOLICITED_PSID = N 
NEGTERM = N 

TERMOAP_RAMDISK_SIZE # 65536 

USERS_TSPASS # 16 

NETID = DEIBMIPF 
NUMSESS # 8 

SRCWIN # 4 

CHECK_IP # 0 

CHECK_LU # 0 

CHECK_LU_QUE = N 

CHECK_LOG = N 
USERS_TN3270 # 16 

TN3270E_SERVER = N 
TN3270E_FUNCTIONS # 31 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

* Data Link Configuration for Instance occl 

* Filename : /usr/oc/sna/dlcfg.occl 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

SCA_DLC_ENTRY : 

LOCAL_SAP_VALUE # 0X01 
LINKJNAME = IPFP2901 

DLC_ENTRY_END 


Figure 137 (Part 2 of 2). OCC Configuration Listing 


12.4.7 Load Configuration Fiie Set 

For your convenience you can have different configuration fiie sets saved on 
various media (for exampie, iocai disk). This menu iets you choose your 
configuration for subsequent processing. For more detaiis about this operation 
see Chapter 4 of the OpenConnect Systems OpenConnect Server II Installations 
and Operations Guide RISC/6000, 350-0285-101.15. 
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CCS occonfig 


Load OCSNA Instance 


Enter an 

Instance Number to Load 

or tALLt. 

. 2 

Instance 

Instance 

Instance 

Instance 

Number 

Name 

Number 

Name 

1 

occl 

2 

vm_via3174 

3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


13 


14 


15 


16 



ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu OCS II RISC/6000 V3.7.5 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods Instance=vm_via3174 


Figure 138. Load Instance Files 

Figure 138 displays each OCSNA instance name and it's cerrespending instance 
number. 

A sample entry for an instance fiie is shown in Figure 111 on page 157. 


12.4.8 Save Configuration Fiie Set 

After having finished the configuration process, don't forget to save the changes 
you made, in order to use the actuai configuration vaiues at the next OCS II 
Gateway Software startup. For more details about this operation see Chapter 4 
of the OpenConnect Systems OpenConnect Server II Installations and Operations 
Guide RISC/6000, 350-0285-101.15. 
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CCS occonfig 


Save OCSNA Instance 


Enter an Instance Number to Save or tALLt. 2 


Instance 

Number 

1 

3 

5 

7 

9 

II 

13 

15 


Instance 

Name 

occl 


Instance 

Number 

2 

4 

6 

8 

10 

12 

14 

16 


Instance 

Name 

vm via3174 


ESC+l=Help ESC+2=ExitPgm ESC+3=PrevMenu 

ESC+4=ConfMenu ESC+5=MainMenu Return=AcceptMods 


OCS II RISC/6000 V3.7.5 
Instance=vm_via3174 


Figure 139. Save Configuration Updates 


12.5 Special Considerations 


12.5.1 TCP/IP Node Considerations 

To test our environment we configured severai TCP/IP nodes in our network (see 
Figure 13 on page 34). The foiiowing notes appiy to aii TCP/IP nodes which 
want to communicate with VSE/ESA via the OCS il Gateway. 

• The TCP/iP impiementation is a standard impiementation and you must 
foilow the guidance given in the apprepriate book, (for exampie for the OS/2 
2.1 environment: TCP/IP V2.0 for OS/2 Installation and Administration, 

SCSI-6075). 

• You must inciude the iP address and hostname for the apprepriate OCS li 
Gateway in the definitions for the route. 

• The OCS II Gateway uses the standard TCP/IP ports for TELNET and FTP 
operations to VSE. The user doesn't need to specify the port number 
parameter when epening a sessien to VSE. if the TELNET and FTP servers of 
AIX (where the OCS II Gateway is instalied) are addressed, a different port 
number needs to be specified. For detaiis see 12.6, “Set up Aiternative Perts 
for AiX TELNET and FTP Servers” on page 186 for setting up aiternative port 
numbers on AiX. 
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12.5.2 Host Access Table (HAT) 

The OC/TELNET Server provides Host Access Table (HAT) services to control 
terminals for logging on to VSE and to define certain characteristics to classes of 
terminals. This involves a two-step process: 

1. Selection 

The incoming TELNET user is matched with a HAT entry in the file 'tstext' 
which resides in directory /usr/oc/sna/etc. A HAT entry has the format: 

class_name:ip_address:port_number:[ip_address_mask: 

[port_number_mask:]] 

After a match is found for that ip_address, the class_name of that entry is 
used for the next step. 

2. Inclusion/Exclusion Process 

The class_name from the first step found will then be used to search for a 
match in the file 'octermcap' which also resides in directory /usr/oc/sna/etc. 
The result of this matching process determines the capabilities of that 
terminal such as: 

• Auto bypass the TELNET Server prompt 

• Default Service Type/Terminal Type 

• Ability to access a specific LU 

• Whether access to the TELNET Server is denied or permitted. 

In our configuration, we made a HAT customization to check the ability to specify 
TELNET Server prompt bypass and TELNET Server access denial. 

Figure 140 and Figure 141 on page 186 show the contents of the HAT we have 
customized for 'tstext' and 'octermcap'. 


#-# 

# Host Access Table (HAT) Section - the @@TSHAT section can reside anywhere 

# in the tstext file. 

# 

# HAT Entry Syntax: 

# entrY_naine: ip_address :port_#: ip_address_inask:port_#_inask: 

# 

# The tallhostst entry will cover all hosts that do not match any other HAT 

# entry. 

# -# 

@@TSHAT 

tcpcl3:192.61.100.199 
allhosts:0:0:0:0: 


Figure 140. Sample Host Access Table (HAT) 'tstext 

The HAT entries in the 'tstext' file shown above provide for a match of all 
IP_addresses for the class 'allhosts' except for address '192.61.100.199' which 
matches class 'tcpcIS'. For more information on the HAT entries for 'tstext' 
please refer to the OC/TELNET Server Manager documentation. 
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# 

# HAT related temcap entry names 

# 

# Modify the following lines for HAT irrplementation. 

# Example: 

# 

tcpcl3:Da:Dp:sv=32 7 8:tt=DEC-VT22 0: 
allhosts:No: 

#hostl:Tl:tl=5:Da:Dp:sv=32 7 8:tt=vt10 0:Su: 

#host2:T1:tl=5:tt=tvi925:tc=host1: 


Figure 141. Sample Host Access Table (HAT)'octermcap' 

The first entry in 'octermcap' shown above gives user 'tcpciS' the abiiity to 
bypass the TELNET prompt when iogging on to VSE. The second entry denies 
TELNET access for 'aiihosts' that is, no TCP/iP host can access VSE. Since 
'tcpciS' was piaced before the 'aiihosts' entry, it takes priority over the second 
entry and aiiows 'tcpciS' to iogin with the service 3278 (3278 emuiation) and is 
recognized as terminai type VT220. For more information on the HAT entries for 
'octermcap' piease refer to the OC/TELNET Server Manager documentation. 


12.6 Set up Alternative Ports for AIX TELNET and FTP Servers 

If OCS li Gateway is instalied on a RS/6000 system as the TCP/IP solution for 
VSE/ESA, there is a high probabiiity that this machine wili mainiy be used for 
that purpose. Based on this assumption, it is easier for TCP/iP users to access 
VSE/ESA via the 'weii known' standard TCP/iP ports, that is, they don't have to 
specify a port number when they use TELNET or FTP to access VSE/ESA. 

However, for OCS II Gateway administrators and system programmers there 
might be a need to access the AIX TELNET and FTP Servers. In this case, the 
file '/etc/services' on AIX has to be modified to assign different port numbers for 
the local (AIX) TELNET and FTP servers. We assigned ports '2020 and 2021' to 
the FTP server (FTP requires two ports) and port '2023' to the TELNET server. 
After '/etc/services' has been changed a refresh of the super daemon 'inetd' is 
necessary to make the new port assignments active. This is done by issuing: 

root@aix320: /> refresh -s inetd 

Now the AIX TELNET and FTP servers can be accessed, as shown in the 
example below: 

[C:\]telnet aix320 -p 2023 

[C:\]ftp aix320 2021 

- Note - 

For FTP, you have to use the listen port 2021 for connection, port 2020 is for 
I/O data only. 

There also are differences for the TELNET and FTP commands. One has to 
specify '-p' for the port, the other does not. Please refer to your host's TCP/IP 
command reference to check the syntax of subject commands. 
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Figure 142 on page 187 shows part of the file 7etc/services' we used for our 
environment. 


echo 

7/tcp 


echo 

7/udp 


discard 

9/tcp 

sink null 

discard 

9/udp 

sink null 

systat 

11/tcp 

users 

daytime 

13/tcp 


daytime 

13/udp 


netstat 

15/tcp 


qotd 

17/tcp 

quote 

chargen 

19/tcp 

ttytst source 

chargen 

19/udp 

ttytst source 

ftp-data 

2020/tcp 

# aix ftp io port 

ftp 

2021/tcp 

# aix ftp listen port 

telnet 

2023/tcp 

# aix telnet listen port 

smtp 

25/tcp 

mail 

time 

37/tcp 

timserrver 

time 

37/udp 

timserrver 

rip 

39/udp 

resource # resource location 

nameserver 

42/udp 

name # lEN 116 

whois 

43/tcp 

nicname 

domain 

53/tcp 

nameserm/er # name-domain serrver 

domain 

53/udp 

nameserver 

mtp 

57/tcp 

# deprecated 


Figure 142. Sample for TCP/IP Service Port Number Assignments 
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Chapter 13. OCS II Gateway Operation 


This chapter: 

• provides instructions on how to start and operate the OCS ii Gateway. 


13.1 Operation Samples (start,stop,status....) 

The OCS ii Gateway is started by an authorized AiX user via the ocsna 
command as shown in Figure 143. Verify that Front Panei Code is aiways "001" 
after initiaiization, otherwise the OCS ii Gateway wiii not work properiy. if you 
instaiied your OCS Ii in a directory other than 7usr/oc/sna', you can direct the 
OCS II process to look for support files by setting an environment variable in the 
7etc/profile' as follows: 

OCSNA = perm_path/sna 
export OCSNA 

Figure 143 shows how the gateway is started from an AIX command line prompt. 
By using the '&' sign, the gateway program executes as a process in the 
background. If you first started the gateway without and you decide at a later 
time to run the process in background, simply press CTRL-Z to stop the process 
and enter bg followed by the ENTER key. The process will then be resumed in 
the background. 

We can also have the program executed automatically at AIX system startup. 

This requires some customization of the AIX system initialization table. The last 
command in Figure 144 on page 190 was added to AIX's system initialization 
table 7etc/inittab' to provide for automatic startup of the OCS II Gateway. 


root@aix320: /usr/oc/bin >./ocsna -i vm_via3174& 

OCSNA Process Started :PID=6796 Fri Jul 05 09:24:26 1996 

0705 09:24:28 38 days remaining before expiration of the OCSNA 
0705 09:24:28 OCS II RISC/6000 V3.7.3 (95/11/14 14:20) 

0705 09:24:32 => Front Panel Code 001 <= 

Figure 143. OCSNA Command Sample 


© Copyright IBM Corp. 1995, 1996 
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init:2:initdefault: 

brc::sysinit:/sbin/rc.boot 3 >/dev/console 2>&1 # Phase 3 of system boot 
powerfail::powerfail:/etc/rc.powerfail >/dev/console 2>&1 # d51225 

rc:2:wait:/etc/rc > /dev/console 2>&1 # Multi-User checks 

fbcheck:2:wait:/usr/lib/dwm/fbcheck >/dev/console 2>&1 # run /etc/firstb 
srcmstr:2:respawn:/etc/srcmstr # System Resource Controller 

rcsna:2:wait:/etc/rc.sna > /dev/console 2>&1 # Start sna daemons 
rctcpip:2:wait:/etc/rc.tcpip > /dev/console 2>&1 # Start TCP/IP daemons 
cons:0123456789:respawn:/etc/getty /dev/console 

piobe:2:wait:/bin/rm -f /usr/lpd/pio/flags/* # Clean up printer flags files 

cron:2:respawn:/etc/cron 

qdaemon:2:wait:/bin/startsrc -sqdaemon 

writesrv:2:wait:/bin/startsrc -swritesrv 

uprintfd:2:respawn:/etc/uprintfd 

rcncs:2:wait:sh /etc/rc.ncs 

infod:2:once:startsrc -s infod 

hcon:2:once:/etc/rc.hcon 

ocsna:2:once:/usr/oc/scr/ocsna -i vm_via3174 > /dev/console 2>&1 


Figure 144. AIX Inittab Sample for OCSNA Auto Startup 

To look at the status of your connections with the VSE host you can enter the 
command sna_status and specify the hostname of the gateway (aix320) as shown 
in Figure 145 on page 191. 
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root@aix320: /usr/oc/bin >sna_status -h aix320 


HOST NAME: AIX320 
PORT ID: 2000 

THE TOTAL NUMBER OF CONTROL UNITS IN THIS CONFIGURATION IS 1. 

INTERNET ADDRESSES : 

CONTROL UNIT : 192.61.100.81 (C03D6451) GATEWAY : 192.61.100.83 (C03D64237) 


INFORMATION FOR RELATIVE CONTROL UNIT 1: 


CONTROL UNIT NAME 
SDLC STATION ADDRESS 
SDLC STATION ROLE 
PHYSICAL UNIT TYPE 


IPFP2209 
04 

SECONDARY 
PU2.0 

LOGICAL UNIT TERMINATION RULE : TERMINATE SELF 
HIGHEST LOGICAL UNIT CONFIGURED FOR THE CONTROL UNIT IS 


CONTROL UNIT TYPE : 41-C 
DATA LINK NAME : IPFP2209 
NRZ/NRZI INDICATOR: NRZ 
EXCHANGE ID(XID) : 2017E0009 


16 


TOTAL PIUS IN: 

TOTAL PIUS OUT: 

CURRENT PU STATE: 

LU DEV NAME 

46 

46 

UP - (ACTIVE) 

UNAME LC 

PID ST SS 

LS 

TG HTLK BRKT 

SNSQ 

RNSQ 

1 

TCP/IP 

IPFT2S9A 

TCP/IP 

2003 

13 00 A 

I 

SS 0000 BETB 

00000 

00000 

2 

TCP/IP 

IPFT2S9B 

TCP/IP 

2003 

12 00 A 

I 

SS 0000 BETB 

00000 

00000 

3 

TCP/IP 

IPFT2S9C 

TCP/IP 

2003 

11 00 A 

I 

SS 0000 BETB 

00000 

00000 

4 

TCP/IP 

IPFT2S9D 

TCP/IP 

2003 

10 00 A 

I 

SS 0000 BETB 

00000 

00000 

5 

TCP/IP 

IPFT2S9E 

TCP/IP 

2003 

9 00 A 

I 

SS 0000 BETB 

00000 

00000 

6 

TCP/IP 

IPFT2S9F 

TCP/IP 

2003 

8 00 A 

I 

SS 0000 BETB 

00000 

00000 

7 

TCP/IP 

IPFT2S9G 

TCP/IP 

2003 

7 00 A 

I 

SS 0000 BETB 

00000 

00000 

8 

TCP/IP 

IPFT2S9H 

TCP/IP 

2003 

6 00 A 

I 

SS 0000 BETB 

00000 

00000 

9 

TCP/IP 

IPFT2S9I 

TCP/IP 

2003 

5 00 A 

I 

SS 0000 BETB 

00000 

00000 

10 

TCP/IP 

IPFT2S9J 

TCP/IP 

2003 

4 00 A 

I 

SS 0000 BETB 

00000 

00000 

11 

TCP/IP 

IPFT2S9K 

TCP/IP 

2003 

3 00 A 

I 

SS 0000 BETB 

00000 

00000 

12 

TCP/IP 

IPFT2S9L 

TCP/IP 

2003 

2 00 A 

I 

SS 0000 BETB 

00000 

00000 

13 

PRT DSC 

IPFT2S9M 


0 

0 00 A 

I 

SS 0000 BETB 00000 00000 

14 

3278-2 

IPFT2S9N 


0 

0 00 A 

I 

SS 0000 BETB 00000 00000 

15 

3278-2 

IPFT2S90 


0 

0 00 A 

I 

SS 0000 BETB 00000 00000 

16 

TCP/IP 

IPFT2S9P 

TCP/IP 

2003 

1 00 A 

I 

SS 0000 BETB 

00000 

00000 


Figure 145. SNA_STATUS Command Sample 

To Stop OCSNA processing and end all sessions established you just need to 
"kill" the OCS process. After logging in as an authorized user, you may want to 
display the process id of OCSNA and use the command 'kill' to stop the process. 
The shutdown process is shown in Figure 146 below. 


ROOT@AIX320: / >PS -EF|GREP OCSNA 

ROOT 7294 1 0 09:42:15 - 0:02 OCSNA-I VM_VIA3174 

ROOT 8407 7879 4 10:21:59 PTS/1 0:00 GREP OCSNA 

ROOT@AIX320: / >KILL 7294 


Figure 146. OCSNA Shutdown Sample 
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Chapter 14. OCS Print Server Installation and Customization 


This chapter covers the OCS Print Server running on a RISC/6000 and provides: 

• a functionai overview of the OCS Print Server 

• detaiied instructions on how to instail the OCS Print Server 

• detaiied instructions on how to customize the OCS Print Server 

• detailed instructions on how to define OCS Print Server sessions in CiCS and 
VTAM on VSE/ESA 


14.1 OCS Print Server Overview 

The OCS Print Server is an AIX process to emuiate muitipie 3287 CICS Report 
Controller terminal printers. 

The print eutput is automatically converted from EBCDIC to ASCII and routed to 
any local or remote printer defined on the AIX system. 

OCS Print Server may be installed on any AIX system and may communicate 
with any OCS II Gateway via TCP/IP. 

Communication with the Gateway is performed using one of the following 
protocols: 

• TN3287 protocol developed by OCS 

• OCS protocol 

The OCS Print Server can be attached to CICS by using one of the following SNA 
protocols: 

• LU1 (also known as SCS operation) 

• LU3 (DSC operation) 


14.2 OCS Print Server Instaiiation 

This is a very simple step: It basically censists ef installing the OCS Print Server 
product diskette. Please refer to Chapter 1 of the OCS Print Server for UNIX - 
User's Guide that describes the installation task in detail. The installation 
command sequence is the following: 

1. mkdir/usr/tmp/oc 

2. cd /usr/tmp/oc 

3. tar -xvf Idevirdevname ./install where rdevname is the I/O device name, (for 
example, rfdO for the diskette drive) 

4. ./install to start the installation script 

The following figures shows the messages appearing during the installation 
process. 


© Copyright IBM Corp. 1995, 1996 
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Installation Script for the OCS Print Se 2 cver 
Copyright 1994 OpenConnect Systems, Inc. 

This script will install the Print Server product on this workstation. 
You will be able to install the product files in directories of your 
choice. The product files will first be extracted from the distribution 
media and stored in a temporary directory. 

Press the [Return] key to continue. 


Press the Enter key. You will then be asked for the installation device. 


I Enter a character device name from which to read the installation media. 


enter Idev/rdevname where rdevname is the I/O device you used on the tar 
command above. 

The following messages will appear: 


X ./eps, 257195 bytes, 503 media blocks. 

X ./eps_start, 14470 bytes, 29 media blocks. 

X ./eps_status, 25969 bytes, 51 media blocks. 

X ./eps_stop, 14438 bytes, 29 media blocks. 

X ./install, 11157 bytes, 22 media blocks. 

X ./ocs_elmadmin, 71391 bytes, 140 media blocks 
X ./ocs_elmalert, 48161 bytes, 95 media blocks. 

X ./ocs_elmd, 107776 bytes, 211 media blocks. 

X ./ocs_elmrpt, 26248 bytes, 52 media blocks. 

X ./ocs_elmusage, 43304 bytes, 85 media blocks. 

X ./ocs_elmver, 7656 bytes, 15 media blocks. 

X ./printcap, 0 bytes, 0 media blocks. 

X ./read.me, 16219 bytes, 32 media blocks. 

X ./tracutil, 64888 bytes, 127 media blocks. 

Product files extracted. 

The product files will now be moved to selected directories. 
The default directories are: 


/usr/oc/eps 

/usr/oc/eps 

/usr/oc/eps 

/usr/oc/eps 


Print Server executables 
Configuration files 
Readme file 

License Manager executables 


During installation, you will have the opportunity to change the default 
directory paths. 


Press the [Return] key to continue. 


Press the Enter key. 

You will be asked if you want to change the default paths. 
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1. Change default 

2. Print Server program executables 

3. Configuration files 

4. Readme file 

5. License Manager program executables 


/usr/oc/eps 

/usr/oc/eps 

/usr/oc/eps 

/usr/oc/eps 

/usr/oc/eps 


Enter choice of directory to change or [Return] to continue 


Either enter the corresponding number if you want to change the defaults or 
press ENTER to aooept the defaults. If you decided to ohange the defaults, follow 
the instructions on the screen. After having either accepted the default or 
changed the Installation paths, you will get the following messages: 


You have chosen the following directories for installation of the Print Server: 

Print Server program executables - /usr/oc/eps 
Configuration files - /usr/oc/eps 

Readme file - /usr/oc/eps 

License Manager program executables - /usr/oc/eps 

Enter [Y] to continue with installation, or anything 
else to abort. 


Reply Y If the paths are correct. 

You will get the following final messages. 


Installing Print Se 2 ver program executables into /usr/oc/eps 
Installing License Manager program executables into /usr/oc/eps. 
Installing configuration files into /usr/oc/eps. 

Installing readme file into /usr/oc/eps. 


Installation conplete. 


14.3 OCS Print Server Customization 

The customization of the OCS II Gateway Is a more complex part. It consists of 
the following three steps: 

1. Customization of the OCS Print Server product described in 14.3.1, 
“Customization of the OCS Print Server” on page 196 

2. Customization of the OCS II Gateway deserlbed In 14.3.2, “Customization of 
the OCS 11 Gateway for OCS Print Server” on page 200 

3. Customization In VSE/ESA described In 14.3.3, “Customization in VSE/ESA” 
on page 200 
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14.3.1 Customization of the OCS Print Server 

The customization of the OCS Print Server product consists of the foilowing 
steps: 

• Providing the iicense manager key 

• Customizing the defauits fiie 

• Customizing the config file 

• Starting the OCS Print Server 


14.3.1.1 Providing the License Manager Key 

Switch to the path on which you installed the License Manager (default is 
/usr/oc/eps) and enter the following command: 

./ocs_elmadmin -c -n -e path 

where path is the path you installed OCS Print Server to (default is /usr/oc/eps). 
You will be given a code that is used to obtain the product key from OCS. Enter 
the license key provided by OCS. A file named 01 will be created with the 
information needed by the License Manager. 


14.3.1.2 Customizing the Defaults File 

The defaults file contains configuration-wide defaults. It must be placed in the 
path in which the OCS Print Server is installed (default is /usr/oc/eps). 

- Note - 

OCS Print Server supports both OCS and TN3278 protocol. 

In our installation we only used the OCS protocol, and therefore only 
describe the configuration required by this protocol. 

For a description of how to set up OCS Print Server for the TN3278 protocol, 
refer to OCS Print Server for UNIX - User's Guide. 


Figure 147 shows the defaults file used in our configuration. 


GATEWAY = aix320 

THRESHOLD = 85 

DTRECTORY = /tmp 

SHELL = /bin/sh 


# Name (or internet addr) of OC unit 

# Congestion stage 1 at 85% usage. 

# Monitor /tmp directory for usage 

# Default shell for print processes 


Figure 147. Defaults File Used in Our Installation 

Table 7 on page 197 contains a short description of the possible parameters 
used in this file. 
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Parameter 

Description 

Default 

GATEWAY 

Specifies the Name or IP-Adress of the OCS II Gateway 


OCS_PORT 

port number for OCS II Gateway 

2000 

PROTOCOL 

protocol type (OCS or TN). 

OCS 

FORMFEED 

YES: causes the emulator to perform a formfeed by 
inserting a formfeed character into the Print 
datastream. 

NO: formfeed is performed by a series of linefeed 
characters. 

NO 

DIRECTORY 

path to monitor to avoid a disk-full condition. 

No 

monitoring 

THRESHOLD 

threshold value for the disk utilization of the path 
specified in the DIRECTORY value. 

If this value is reached, OCS Print Server enters 
"congestion avoidance" mode. 

For a description of this mode, refer to OCS Print 

Server for UNIX - User's Guide. 

No 

monitoring 

PTHRESH 

maximum number of subprocesses of OCS Print Server 
before "congestion avoidance" mode is entered. 

For a description of this mode, refer to OCS Print 

Server for UNIX - User's Guide. 

No 

subprocess 

monitoring 

PRINTCAPDIf 

\ path that contains the printcap file used to perform the 
EBCDIC to ASCII conversion. 

For customization of the printcap file, refer to OCS Print 
Server for UNIX - User's Guide. 

path, 

where 

OCS Print 
Server is 

installed. 

PREFIXDIR 

path to prefix files 

no usage 
of prefix 
files 

POSTFIXDIR 

path to postfix files 

no usage 
of postfix 
files 

LINELEN 

maximum number of characters that fit on a line at the 
target printer. 

f32 

BUFSIZE 

buffer size used for LU3 type printers 

3168 

WRITE2FILE 

YES: Incoming print requests are directly sent to the 
printer 

NO: print requests are first written to a file and then 
printed offline 

NO 

SHELL 

fully qualified path to the command shell used for the 
printing subprocesses. 

/usr/bin/sh 


Table 7. Default File Parameters and Defaults 


14.3.1.3 Customizing the Config File 

The config file specifies the actual printer emulation sessions. It must be placed 
in the path in which the OCS Print Server is installed (default is /usr/oc/eps). 


Chapter 14. OCS Print Server Installation and Customization 197 




















— Note - 

OCS Print Server supports both OCS and TN3278 protocol. 

In our installation we only used the OCS protocol, and therefore only 
describe the configuration required by this protocol. 

For a description of how to set up OCS Print Server for the TN3278 protocol, 
refer to OCS Print Server for UNIX - User's Guide. 


Figure 148 shows the defaults file used in our configuration. 


LU_ENTRY_STflRT: 

LUNAME = IPFT2S9M 

PRTCMD = tlpr -Pibm40291t 

LU_ENTRY_END: 


Figure 148. Config File Used in Our Instaiiation 

Every session defined in the config file must be enclosed by LU_ENTRY_START 
and LU_ENTRY_END. Table 8 on page 199 contains a short description of the 
possible parameters used in this file. 
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Parameter 

Description 

Default 

SESSID 

Name of printer emulation session 

Value specified for 

LUNAME 

LUNAME 

name of the LU to be used on OCS II Gateway 
The LU must be defined as described 
inChapter 5, “Defining the OCS II Gateway to 
the Host” on page 41 


LUNUM 

LU number to the used on OCS II Gateway 
(valid only in combination with PUNUM) 


PUNAME 

name of the PU to be used on OCS II Gateway 
(valid only in combination with LUNUM) 


TRACELVL 

trace level for this session. 

For details about tracing see OCS Print Server 
for UNIX - User's Guide 

No trace 

PRTCMD 

AIX command used to print requests from this 
session. 

Ipr 

EXTENDSC 

S Allow "invalid" control codes in LU1 or LU3 

datastreams 

YES 

SUBCHAR 

Character to be substituted for invalid control 

codes. 


PREFIX 

file to be inserted in the print stream before 
the print request 

only valid when PREFIXDIR specified in 
defaults file 


POSTFIX 

file to be inserted in the print stream after the 
print request 

only valid when POSTFIXDIR specified in 
defaults file 


PRINTCAP 

path to printcap file. 

May be specified absolute (leading '/') or 
relative to PRINTCAPDIR (specified in defaults 
file). 

The printcap file may be used to change the 
EBCDIC to ASCII translation tables 

printcap 

PCAPENT 

specifies entry in printcap file to use for this 
sessions. 

For a detailed description of printcap files refer 
to OCS Print Server for UNIX - User's Guide 


INDEX 

add job number suffix when WRITE2FILE=YES. 

YES 

FILENAME 

name of the file to use when WRITE2FILE=YES 

see OCS Print Server 

for UNIX - User's 

Guide 


Table 8. Config File Parameters and Defaults 


Additionally the following defaults file parameters (as described in14.3.1.2, 
“Custemizing the Defaults File” on page 196) may be overwritten on a session 
basis: 

• PORT 

• PROTOCOL 

• GATEWAY 

• FORMFEED 

• LINELEN 

• BUFSIZE 
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• WRITE2FILE 

• SHELL 


14.3.1.4 Starting the OCS Print Server 

To start the OCS Print Server, the following steps have to be performed: 

• Startup of the Elan License Manager 

• Startup of OCS Print Server backgroup process 

To automate this procedure, the AIX in Figure 149 was created. 


/usr/oc/eps/ocs_elmd -e /usr/oc/eps 
/usr/oc/eps/eps& 
sleep 10 

/usr/oc/eps/eps_status 


Figure 149. OCS Print Server Startup Sheil Script 
This shell script performs three tasks: 

1. Start the Elan License Manager using the keys from the /usr/oc/eps path 

2. Start the OCS Print Server process 

3. Check the status of the OCS Print Server process after 10 seconds. 


14.3.2 Customization of the OCS II Gateway for OCS Print Server 

The LUs used by OCS Print Server must be defined to OCS II Gateway using one 
of the following LU type definitions: 

• Type 9 3287 LU 1 (SCS Operation) 

• Type 10 3287 LU 3 (DSC Operation) 

The definitions must match the LU type definitions in VTAM as described in 
14.3.4, “VTAM Customization.” These definitions are done using occonfig on 
OCS II Gateway as described in 12.4.2, “SNA Level Data Link Configuration” on 
page 163. In our installation we used LU IPFT2S9M defined as LU 3, as shown in 
Figure 123 on page 167. 


14.3.3 Customization in VSE/ESA 

The OCS Print Server customization consists of the following steps: 

• VTAM customization 

• CICS customization 


14.3.4 VTAM Customization 

The following customization tasks are required in VTAM: 

• Define the logmode table and entries for the applications and LUs 

• Add the LU definitions for the OCS II Gateway LUs 
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14.3.4.1 Logmode Table OCSBIND 

The sample job listed In A.6, “OCSBIND MODETAB for OCS Products” on 
page 351 Is used to create the OCSBIND logmode table. OCS Print Server uses 
the OCSSCS or OCSDSC entries listed in Figure 150. 


OCSSCS 

MODEENT LOGM3DE=OCSSCS, 

C 


EMPROF=X<:03<:, 

C 


TSPROF=X<:03<:, 

C 


PRIPROT=X<:Bl<:, 

C 


SECPROT=X<:90<:, 

C 


CCMPROT=XC30809, 

C 


RUSIZES=X98587<:, 

C 


SRCVPAC=X902<:, 

c 


PSNDPAC=X904<:, 

PSERVIC=X901000000E100000000000000C 

c 

OCSDSC 

MODEENT LOGM3DE=OCSDSC, 

c 


FMPROF=X<:039, 

c 


TSPROF=X<:039, 

c 


PRIPROT=X9Bl<:, 

c 


SECPROT=X9909, 

c 


CCMPROT=X930809, 

c 


RUSIZES=XC8587<:, 

c 


SRCVPAC=X902<:, 

c 


PSNDPAC=X904<:, 

PSERVIC=X90300000000000000000002009 

c 


Figure 150. Logmode Entries Used for OCS Print Server 


In our case, OCSSCS can be used for LU1, OCSDSC for LU3 operation. 


14.3.4.2 VTAM LU Definition 

The complete OCS II Gateway LUs definition Is listed in Figure 24 on page 47, 
and A.3, “VSE TCPSW.B Switched Major Node” on page 342. 

Figure 151 lists the LU definitions used by OCS Print Server. We defined LU 
IPFT2S9M for our test environment. 


IPFT2S9M LU LOCADDR=13,DLOGiyDD=OCSDSC 

Figure 151. LU Used for OCS Print Server 

The DLOGMOD parameter has to match the definitions made in OCS II Gateway 
described in 14.3.2, “Customization of the OCS II Gateway for OCS Print Server” 
on page 200. 

• If the LU In OCS 11 Gateway is defined as 3278 LU1 (code 9), the VTAM 
DLOGMOD must be an LU1 logmode, in our case OCSSCS. 

• If the LU In OCS II Gateway Is defined as 3278 LU3 (code 10), the VTAM 
DLOGMOD must be an LU3 logmode. In our case OCSDSC. 

The logmodes OCSSCS and OCSDSC can be found In Figure 150. 
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14.3.5 CICS Customization 

This section covers the definitions in CICS to enabie VSE/ESA users to use the 
CCS Print Server CICS terminal printer. We used the CEDA transaction to define 
the following resources to CICS: 

• Typeterm PSLU3 

• Terminal 2S9M 

We filed these resources under the group VSEGROUP. After the resources are 
defined, we used CEDA Install Group(VSEGROUP) to activate the definitions. 
Partial screen images of the CEDA sessions are reproduced to show the 
definitions we added or changed. 


14.3.5.1 Define CICS Terminal Printer (DSC) 

CEDA DEFine TYpeterm(PSLU3) is used to define the OCS Print Server terminal 
PSLU3 to CICS as shown below. 
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CEDA DEFine 


TYpeterm 


PSLU3 



Group 


VSEGROUP 


RESOURCE TYPE 





DEVice 

=> 

LUTYPE3 


TERirmodel 

=> 

2 



SESsiontype 

=> 




PRINTErtype 

=> 

3284 



LDclist 





SHippable 

==> 

Yes 


No I Yes 

MAPPING PROPERTIES 



PAGesize 

==> 

024 , 

080 

0-999 

ALTPage 

==> 

000 , 

000 

0-999 

ALTSUffix 

=> 




EMhpam 

==> 

No 


No I Yes 

OBCperid 

==> 

No 


No I Yes 

PAGING PROPERTIES 




AUTOPage 

==> 

Yes 


No I Yes 

DEVICE PROPERTIES 




DEFscreen 

==> 

024 , 

080 

0-999 

ALTSCreen 

=> 

f 


0-999 

APLKybd 

==> 

No 


No I Yes 

APLText 

==> 

No 


No I Yes 

FOrnfeed 

==> 

Yes 


No I Yes 

BAcktrans 

==> 

No 


No I Yes 

CGcsgid 

==> 

00000 

, 00000 

0-65535 


SESSION PROPERTIES 


AScii 

==> No 

No 

I 7 I 8 


SENdsize 

==> 03840 

0-30720 


RECEivesize 

==> 03840 

0-30720 


BRacket 

: Yes 

Yes 

I No 


LOGMode 

=> 




DIAGNOSTIC DISPLAY 




ERRLastline 

: No 

No I 

Yes 


ERRIntensify 

: No 

No I 

Yes 


ERRColor 

: NO 

NO I 

Blue I 

Red I Pink | Green | 



Turquoise | 

Yellow I NEutral 

ERRHilight 

: No 

No I 

Blink I 

Reverse | Underline 

OPERATIONAL PROPERTIES 




AUTOConnect 

==> No 

No 

I Yes I 

All 

ATI 

==> Yes 

No 

Yes 


TTi 

==> Yes 

Yes 

I No 


CReatesess 

==> Yes 

No I 

Yes 


RELreq 

==> Yes 

No 

Yes 


DIscreq 

==> Yes 

Yes 

I No 


Nepclass 

==> 000 

0-255 


SIgnoff 

==> Yes 

Yes 

No I 

Logoff 

MESSAGE RECEIVING PROPERTIES 




ROutedmsgs 

==> All 

All 

I None 

I Specific 

LOGOnmsg 

==> No 

No 

Yes 


APPLICATION FEATURES 




BUildchain 

==> No 

No I 

Yes 


USerarealen 

=> 255 

0-255 


loarealen 

==> 00080 , 00080 

0-32767 


UCtran 

==> No 

No 

I Yes I 

Tranid 

RECOVERY 





RECOvoption 

=> Sysdefault 

Sysdefault 

I None 
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CEDA DEFine TErminal{2S9M) is used to define the OCS Print Server terminai 
2S9M to CiCS as shown beiow. 


CEDA DEFine 
TErminal : 2S9M 

Group : VSEGROUP 

AUTINSTModel ==> No 
AUTINSTName => 

TERMINAL IDENTIFIERS 
TYpeterm ==> PSLU3 
NEtname ==> IPFT2S9M 

Console ==> No 

REMOTESystem => 
REMOTEName ==> 

Modename => 
ASSOCIATED PRINTERS 
PRINTER => 

PRINTERCopy ==> No 
ALTPRINTEr ==> 
ALTPRINTCopy ==> No 
SPOOLTo => 

PIPELINE PROPERTIES 
POol => 

TAsklimit ==> No 
OPERATOR DEFAULTS 
OPERId => 

OPERPriority ==> 000 
OPERRsl ==> 1 

OPERSecurity => 1 
Userid => 

NAtlang => 

TERMINAL USAGES 


TRansaction 

=> 


TEnnpriority 

==> 

000 

Inservice 

==> 

Yes 

PRINTER DATA 



SPOOLDest 

==> 

IPFT2S9M 

SPOOLPRTRsl 

==> 

Public 

SPOOLPRTTo 

==> 

01 

PRINTEDmsg 

==> 

No 

PRINTImmed 

==> 

Yes 

SESSION SECURITY 


SEcurityname 

=> 


ATtachsec 

==> 

Local 

Bindpassword 

=> 



No I Yes I Only 


No I 0-99 


No I Yes 
No I Yes 


No I 1-32767 


0-255 


0-255 
Yes I No 


0-24 I Public 
0-59 

No I Yes 
No I Yes 


Local I Identify I Verify 
PASSWORD NOT SPECIFIED 


0-24, . . . 
1-64, . . . 
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Chapter 15. OCS Print Server Operation 


This chapter: 

• provides instructions on how to start and operate the OCS Print Server 

• shows exampies how to print a fiie on OCS Print Server 


15.1 Operation Samples (start,stop,status....) 

The OCS Print Server is started using the startup script as shown in Figure 149 
on page 200. 

Figure 152 shows how the print server is started from an AiX command iine 
prompt. 


root@aix320: 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
Jul 25 09:46 
1996. 


/usr/oc/scr >starteps 

48: Elan License Manager - Copyright 1993 Elan Conputer Group, Inc 
48: ELMO 2.3.2 started on aix320 (aix320c03d6451) . 

48: Vendor ID = lb94ae; Hostcode = 0500 = HOSTNAME+IPADDR. 

48: PID = 10202. 

48: Port = 6421. 

48: Log file = <none>. 

48: Key path = /usr/oc/eps. 

48: Resource file = <none>. 

48: Message level = 3. 

48: Loaded key /usr/oc/eps/01 (ocsps) 10 tokens exp Dec 22 09:00:0 


IPFT2S9M 

Status = Up (PRINTER_AVAILABLE) 

Gateway = aix320 

Luname = IPFT2S9M 

Stats = No jobs have been started on this session. 

root@aix320: /usr/oc/scr > 


Figure 152. OCS Print Server Startup Sample 

The foiiowing commands are used to operate the OCS Print Server: 

1. eps_status to check the status of the print server 

2. eps_stop to stop one or more print session(s) or the whoie print server 

3. eps_start to start one or more print session(s) stopped using eps_stop. 

Aii three commands have the foiiowing common parameters: 

• -h I -H to specify the hostname or ipaddress where the OCS Print Server is 
running (defauit is the iocai host) 

• -p I -P to specify the command port for the print server (defauit is 3050) 

• -s I -S to specify the print session to which this command reiates. For 
specifiying muitipie sessions, a traiiing wiidcard character may be used 
(defauit is all sessions) 
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The eps_status command returns the status of the print server sessions. The 
status is iisted in short form as shown in Figure 152. 

To get a detaiied status, use the -f parameter. Figure 153 shows the status 
returned when using this parameter. 


root@aix320: / >/usr/oc/eps/eps_status ~f 


IPFT2S9M 

Status = Up (PRINTER_AVAILABLE) 

Gateway = aix320 

Luname = IPFT2S9M 

Stats = No jobs have been started on this session. 

Protocol = CCS Port = 2000 

Linelen = 132 Buffer size = 3168 Line limit = 0 

Formfeed = NO Index = YES 

Ex-SCS = NO SubXCS = YES CharXCS = - 


PRTCMD = Ipr -Pibm40291 
Printcap = /usr/oc/eps/printcap 
Pcapent = NONE 
Prefix = NONE 
Postfix = NONE 
Shell = /bin/sh 
root@aix320: / > 


Figure 153. eps_status -f Sample Output 

The eps_stop command stops the session(s) specified with the -s parameter. 

If the iast active session is stopped, or if this parameter is omitted, the print 
server process eps wili automaticaliy stop. 

- Note - 

If you accidentally stopped the print server process by stopping the last 
active print session, you may restart it by starting the eps program in 
background: 

/usr/oc/eps/eps& 


Print sessions that are currently printing will finish before they are stopped. 
To stop the session immediately, the -n parameter may be specified. 

The eps_start command is used to start sessions, that were stopped with 

eps_stop. 

- Note - 

Since we only defined one print session, we were not able to test the 
eps_start command, since the print server is always terminated if the last 
active print session is stopped. 


If you stopped the print server process and want to terminate the license 
manager, you have to kill the licence manager process. Figure 154 on page 207 
shows a sample scenario: 
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root@aix320: / >ps -ef | grep ocs_elmd 

root 9473 7923 3 12:05:57 pts/2 0:00 grep ocs_elind 

root 10202 1 0 09:46:48 - 0:00 /usr/oc/eps/ocs_elmd -e /usr/oc/epo 

root@aix320: / >kill 10202 

Jul 25 12:08:35: Received signal 15. ELMO Terminated. 
root@aix320: / > 


Figure 154. Stopping the Licence Manager 


15.2 Printing Fiies from CICS Report Controiier 

Before you can use the OCS Print Server you have to start the printer as defined 
to CICS. 

The printer is either started in CICS Report Controller (transaction CEMS) using 
printer selection or by using the VSE/POWER command PSTART DEV. 

Figure 155 shows a sample response. 


pstart dev, 2s9m, syscicsa, a 

KR 0015 1C39I COMMAND PASSED TO VSE/POWER 

FI 0001 1QY3I DEVICE 2S9M STARTED, DDS=SYSCICSA, TIME=16:32:43 
FI 0001 1QY2I DEVICE 2S9M WAITING FOR WORK, DDS=SYSCICSA 
F2 0002 DFH5491 TASK 00610 , TERMINAL 2S9M - THIS TERMINAL, SERVING 
DESTINATION IPFT2S9M HAS BEEN STARTED. 16:32:43 07/25/96 


Figure 155. PSTART DEV Sample Console Output 

After the device has been started, you can print files using CICS Report 
Controller or by specifying DEST=(*,c/esf) on the VSE/POWER * $$ LST cards. 

dest stands for the destination that is served by this printer, as indicated by 
message DFH5491 in Figure 155. 

When a print request is processed by OCS Print Server, you will get messages 
on the AIX user ID that started the print server process on AIX. Figure 156 
shows some of these messages. 


Jul 25 14:54:20: root@aix320 [1], ocsps (01) : LID 1 issued. 

Jul 25 14:54:21: root@aix320 [1], ocsps (01): LID 1 returned (used: 0: 


Figure 156. PSTART DEV Sample Console Output 

To Stop the printer on VSE, either stop it in CICS Report Controller or use the 
VSE/POWER PSTOP DEV command. 
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Chapter 16. OpenConnection for Channel Installation and 
Customization 


This chapter: 

• provides instructions on how to instaii and customize the OCC hardware. 

Piease see 2.2, “OpenConnection for Channei (OCC)” on page 8, fer a shert 
overview ef the OCC. 


16.1 Installation Summary 

The feiiowing wiii briefiy describe the OCC instaiiation and custemization 
procedures. The different steps required for iocai instaiiation of the OCC are: 

1. RiSC/6000 host software instaiiation 

2. instaiiing OCC Hardware 

3. Configuring OCC Hardware 

4. OCC Customization 

5. Configuring the SNA best for OCS ii Gateway 


16.1.1 RISC/6000 Host Software Installation 

The OCC software instaiiation on a RiSC/6000 host can be ciassified as the OCS 
ii Gateway instaiiation. 

The OCC product is being instaiied on a RiSC/6000 workstation running the OCS 
ii Gateway with the foiiowing software components: 

• OCS ii Gateway Operating Software 

• OCC Administration Software 

When the OCC preduct is instaiied on a RiSC/6000 workstation with OCS ii 
Gateway software, the gateway operating software must be at Version 3.6.4 or 
iater in order to support OCC communication. 


16.1.1.1 OCC Administration Software Installation 

This is a very simpie step: it basicaily consists of instaiiing the OCC product 
diskette. Piease refer te Chapter 2 of the OpenConnection for Channel 
Installation, Administration, and Operations Guide, 350-0466-101.01 for detaiied 
instructions. 

The instaiiation command sequence is the foiiowing: 

1. mkdir/usr/tmp/occ 

2. cd /usr/tmp/occ 

3. tar -xvf Idev/rdevname 

where rdevname = i/0 device name (for exampie, rfdO for the diskette 
drive) 
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4. ./occinstall, to start the installation job 

Figure 157 shows the menu displayed when the installatien exec (occinstall) is 
invoked. 


CpenConnect Systems Incorrporated 
OpenConnection Channel Installation Procedure 

1) INSTALL or UPGRADE the OCC Supporting Software 

2) VERIFY Checksums 

3) REMOVE the OCC Supporting Software 

4) Get HELP for this Installation Procedure 

5) EXIT 


Copyright 1995. CpenConnect Systems Incorporated. 
2711 LBJ Freeway, Dallas, TX 75234 
Technical Assistance: (214) 888-0678 
Sales and Information: (214) 484-5200 

Enter selection number: 


Figure 157. OCC Installation Exec Main Menu 

By choosing selection "I" the OCC product code is loaded into the following 
directories: 

usr/tmp/oc, usr/oc/occ, and usr/oc/bin. 


16.1.2 Installing OCC Hardware 

The hardware installation of the OCC assumes that the SCSI host (for example, 
OCS II Gateway) has already been installed on the TCP/IP network, tested, and 
is operational. 

For detailed informatien on the OCC Hardware Installatien, please refer te: 
OpenConnection for Channel Installation, Administration, and Operations Guide, 
350-0466-101.01 


16.1.3 Configuring OCC Hardware 

The OCC is configured as an RMT SCSI tape device with an SCSI channel 
interface address ID. Under the SCSI address ID, OCC creates eight Legical 
Units with eight SCSI sub-addresses. 

During RISC/6000 power-up initialization, the AIX operating system obtains 
definitions for SCSI devices attached te the interface. 
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The RISC/6000 UNIX host performs an auto-configure function during 
initialization, and checks for newly installed devices on the SCSI interface, 
automatically configures the devices, and makes them available. 


The following describes the SCSI configuration: 

1. After the power-up initialization of the RISC/6000, verify that the OCC has 
been detected by displaying a list of installed devices, by entering the 
following command: 

Isdev -C 

2. Verify the OCC device by its preselected SCSI ID address, and note the 
device names assigned to the OCC, as in the following example, where the 
preselected SCSI ID address of 4 is reflected by -40, -41,....-47. 


rmtO 

Available 00-01-00-40 

Other SCSI Tape Drive 

rmtl 

Available 00-01-00-41 

Other SCSI Tape Drive 

rmt2 

Available 00-01-00-42 

Other SCSI Tape Drive 

rmt3 

Available 00-01-00-43 

Other SCSI Tape Drive 

rmt4 

Available 00-01-00-44 

Other SCSI Tape Drive 

rmtS 

Available 00-01-00-45 

Other SCSI Tape Drive 

rmt6 

Available 00-01-00-46 

Other SCSI Tape Drive 

rmt7 

Available 00-01-00-47 

Other SCSI Tape Drive 

Under the 

OCC's SCSI channel interface address, the OCC creates eight 


sub-addresses for Logical Units. In the above example, Logioal Unit Numbers 
(LUNs) are represented by devise names rmtO, rmtl, ..., rmt7. 

The definitions for the OCC's eight Logical Units must be modified slightly 
using the RISC/6000 AIX utility program, the System Management Interface 
Tool (SMIT). 

3. From the AIX prompt display the SMIT System Management screen by 
entering: 

SMIT 

4. From the SMIT System Management soreen, display the SMIT Devices by 
entering: 

Devices 

5. From the SMIT Devices screen, display the SMIT Tape Drive screen by 
selecting: 

Tape Drive 

6. From the SMIT Tape drive screen, display the SMIT Tape Drive Selection 
Window by selecting: 

Change/Show Characteristics of a Tape Drive 

7. Select a Logical Unit Number (LUN) definition line, and press the 

enter key 

to display that LUN's interactive Change/Show Tape Drive Characteristics 
Screen. 

8. In the Change/Show Characteristics of a Tape Drive Screen, change the 
BLOCK size from 512 to 000. This tells the system to run with variable blook 
size. 

9. In the Change/Show Characteristics of a Tape Drive Screen, change the Use 

EXTENDED file marks from yes to no. 
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10. Press the enter key to accept the changes and to redisplay the Tape Drive 
Selection Window. 

11. Repeat steps 7 through 10 until all eight tape drives/LUNs have been 
reconfigured. 


16.1.4 OCC Customization 

In order to complete the OCC Installation, several customization steps have to 
be completed: 

• Customize the OCS II Gateway 

• Configure OCC with OCC Configuration file 

• Configure the SNA host for OCS II Gateway 


16.1.4.1 Customize OCS II Gateway 

The gateway software must be configured to include OCC definitions. We 
recommend to use the configurator program 'occonfigT 

The following is a short description of these steps. 

1. Enter the command: 

occonfig 

You will get the Main Menu as described in Figure 113 on page 158. 
Continue through the screens until you have the Specify Internet Addresses 
screen. 

In the following, not every screen is mentioned, it is assumed that you have 
gone through all the customization screens as described in 12.4, 
“Customization” on page 156. 

2. In the Specify Internet Addresses screen, we entered the following address: 

192.61.100.81, and pressed enter 

3. On the following screen, the Data Link Values, make sure the Datalink buffer 
size is 265, and Datalink encoding is specified as NRZ 

4. On the Physical Unit Definition screen, we specified the PU name as: 

IPFP2901 

5. On the Display All Logical Units, we specified the LU Names as follows: 
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CCS occonfig Display All Logical Units 

To configure LU<:s, enter the LU name and LU type. See Help for LU types. 


LU Name Type 

1) IPFT2S9A 14 

5) IPFT2S9E 14 

9) IPFT2S9I 14 

13) IPFT2S9M 10 

17) 

21 ) 

25) 

29) 

33) 

37) 

41) 

45) 

49) 

53) 

57) 

61) 

ESC+l=Help 
ESC+4=ConfMenu 


LU Name Type 

2) IPFT2S9B 14 

6) IPFT2S9F 14 

10) IPFT2S9J 14 

14) IPFT2S9N 1 

18) 

22 ) 

26) 

30) 

34) 

38) 

42) 

46) 

50) 

54) 

58) 

62) 


LU Name Type 

3) IPFT2S9C 14 

7) IPFT2S9G 14 

11) IPFT2S9K 14 

15) IPFT2S90 1 

19) 

23) 

27) 

31) 

35) 

39) 

43) 

47) 

51) 

55) 

59) 

63) 


LU Name Type 

4) IPFT2S9D 14 

8) IPFT2S9H 14 

12) IPFT2S9L 14 

16) IPFT2S9P 14 

20 ) 

24) 

28) 

32) 

36) 

40) 

44) 

48) 

52) 

56) 

60) 

64) 


ESC+2=ExitPgm ESC+3=PrevMenu OCS II RISC/6000 V3.7.5 

ESC+SdMainMenu Return=AcceptMods Instance=ibml 


Figure 158. Logical Unit Configuration 

6. On the Miscellaneous System Wide Parameters, the Instance Administration 
Port Number is specified as: 

2001 

7. On the Data Link Configuration screen, the relative Link Station number was 
entered as default: 

1 

8. On the Link Configuration screen, the Link Station Type was specified in our 
case as: 

SCA 

9. On the SCA Link Configuration screen, the Host SubChannel Address was 
specified as: 

01 

And the Link Name as: 

IPFP2901 


16.1.4.2 Configure OCC with OCC Configuration File 

The OCC configuration file is an ASCII INI file used to drive the OCC 
Administration Daemon. The OCC configuration can be done in two different 
ways: 

1. Using the interactive configuration program ('configurator'). 

2. Editing the configuration file sea.ini manually. 

The first method is recommended as you are prompted to view and/or modify all 
OCC configuration parameters. To invoke the configuration program, enter the 
command: 
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configurator usr/occ/sca.ini 

from the usr/oc/occ directory. Figure 159 shows the Main Menu. 


root@aix320:/oc/occ >scacl 
.start OCC Admin Client session 

ScaCmd: 

ScaCmd:configurator/usr/occ/sea.ini 

* SCA Interactiv Configurator started. * 

* Enter <:q<t at any time to exit. * 

Enter the SCA Resource ID to configure. 
Choose from the following SCA Resources. 

The default is CAll SCA Resources/. 

ID Resource 

1 SCA Server 

2 SCA Startup 

3 SCA Device Name 

4 SCA Global 

5 SCA LDH3274 

6 SCA LDHGTO 

7 SCA Channel 

q Quit SCA Interactive Configurator 


Figure 159. OCC Configurator Main Menu 

You can seiect any one of the submenu options or you can press the Enter key 
to begin step-by-step prompting. If you need more detaiied information on the 
OCC configurator, piease refer to Appendix G of the OpenConnection for Channel 
Installation, Administration, and Operations Guide, 350-0466-101-01. 

We seiected: 

• SCA Server 

• SCA Startup 

• SCA Device name 

• SCA Channei 

Our configuration output, the sea.ini fiie is shown in Figure 160 on page 215. 
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PortNuinbe2:=5 0 0 

DefaultDirectory=/usr/oc/occ 
SCALoadImage=/usr/oc/occ/lsca.s2 
SCADunpFile=/usr/oc/occ/core.sea 
[SCAStartup] 

LoadSCA=yes 
StartSCA=Yes 
ConfigureSCA=yes 
EnableSCA=Yes 
AutoDuirp=Yes 
[UnixDeviceMap] 

LUNO=/dev/rmtO 

LUNl=/dev/rmtl 

LUN2=/dev/rmt2 

LUN3=/dev/rmt3 

LUN4=/dev/rmt4 

LUN5=/dev/rmt5 

LUN6=/dev/rmt6 

LUN7=/dev/rmt7 

[SCA] 

MemPercent3274=90 
MemPercentGTO=l0 
[LDH3274] 

IBUFsize=265 
OBUFsize=4120 
IBUFpercent=5 0 
LoMarkpercent=50 
[LDHGTO] 

IBUFsize=32768 
OBUFsize=32768 
IBUFpercent=5 0 
[Channel] 

Highspeed=no 

DataStreaniing=no 

SelectPrioritYHigh=no 


Figure 160. Configuration File sea.ini 


16.1.5 Configure the SNA Host for OCS II Gateway 

On the mainframe SNA host, there are I/O and VTAM generation definitions that 
relate to the OCC and to the OCS II Gateway. The definitions on the SNA host 
must correlate with the corresponding definitions on the RISC/6000 host for OCC 
and OCS II Gateway. 

In order to define the channel attached OCC to the operating system (VSE/ESA), 
it may be necessary to do an lOCP generation. 

• Channel Path ID (CHPID) Definitions 

- TYPE=BL for Block Multiplexer 

- TYPE = BY for Byte Multiplexer 

• Control Unit (CNTLUNIT) Definitions 

- CUNUMBER=280 for Control Unit Address 280 

- PROTOCOL=D for Direct Coupled (DC) Interlocked 

- PROTOCOL=S for Low Speed Datastreaming (up to 3.0 MB/s) 

- PROTOCOL=S4 for High Speed Datastreaming (up to 4.5 MB/s) 
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- UNIT=3705 

• I/O Device (lODEVICE) Definitions 

- UNiT=3705 

Our controi unit definitions are shown in Figure 161. 


CNTLUNIT CUNUMBR=2240,PATH=(22),UNIT=3705,UNITADD=((00,32)),SHARED=N, C 
PROTOC]>D 

lODEVICE ADDRESS=(2200,32) ,CUNUMBR= (2240) ,UNIT=3705,MODEL=E8 


Figure 161. Control Unit Definitions 

For the VSE/ESA and VSE VTAM definitions, piease refer to 5.3, “VSE/ESA with 
OSCII Gateway Attached via the OCC” on page 56. 
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Chapter 17. OpenConnection for Channel Operation 


This chapter: 

• provides instructions on how to start and operate the OCC hardware. 

Please see 2.2, “OpenConnection for Channel (OCC)” en page 8, for a short 
overview ef the OCC. 


17.1 OCC Operation Samples 

When the OCC is powered up, the channel status online enable LED is on, and 
the Front Panel Code "-0001-'' is displayed. 


17.1.1 Starting the OCC Administration Daemon 

The scaad cemmand is used to start the OCC Administration Daemon process. 
It must be directed to the background using the & sign. Figure 162 shows the 
start script of scaad and the corresponding ocsna process. 


/usr/oc/bin/scaadS 
sleep 30 

/usr/oc/bin/ocsna -i occls 


Figure 162. Startsca Script Sampie 

Figure 163 on page 218 shews how the precesses are started using the startsca 
script. 


© Copyright IBM Corp. 1995, 1996 
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root@aix320: /usr/oc/scr >startsca 

Processing completed for INI configuration file /usr/oc/occ/sca.ini. 

■*^'>'r***'>'r**'*^'>'r**'*^'>'r**'*^7'r***'>'r**'*^'>'r**'*^'>'r**'*^'>'r***7'r**'*^'>'r**'*^'>'r***7'r***7'r**'*^'>'r**'*^^'*’*'*^ 

* SCA Admin Process started: PID=8544 Fri Jul 19 09:52:56 1996 

* Version: 1 Release: 3 (04/03/96 16:28) 

■*^'>'r***'>'r**'*^'>'r**'*^'>'r**'*^'>'r***'>'r***'>'r**'*^'>'r**'*^7'r***'>'r**'*^'>'r**'*^'>'r**'*^'>'r***'>'r**'*^'>'r**'*^'>'r* 

IB:Started PID=8289 

OB:Started PID=9058 

AD:SCA is in power-up-reset state 

AD:SCA Firmware VI.R3 

AD:SCA is setup for AIX 

AD:Beginning SCA startup procedures 

AD:Firmware coirpatibility for S2 file is VI.R3 

AD:SCA startup procedures corrpleted successfully 

AD:Listening on port 500 

OCSNA Process Started :PID=7824 Fri Jul 19 09:54:21 1996 


0705 09:54:28 24 days remaining before expiration of the OCSNA 
0705 09:54:28 OCS II RISC/6000 V3.7.3 (95/11/14 14:20) 

0705 09:54:32 => Front Panel Code 001 <= 


Figure 163. SCAAD and OCSNA Startup Sample 

To Stop scaad processing and end all sessions established you just need to "kill" 
the scaad process. After logging in as an authorized user, you may want to 
display the process id of scaad and use the command 'kill -9 ProcessID' to stop 
all three processes. The shutdown process is shown in Figure 164 below. 


root@aix320: 

/ >ps 

-efIgrep ocsna 


root 7294 

1 

0 09:53:52 

- 

0:02 

root 8407 

7879 

4 10:21:59 

hft/0 

0:00 

root@aix320: 

/ >lcill 7294 



root@aix320: 

/ >ps 

-efIgrep scaad 


root 6694 

6437 

0 09:52:55 

hft/0 

0:03 

root 7207 

6694 

0 09:53:02 

- 

0:00 

root 7264 

6694 

0 09:59:02 

- 

0:00 

root 8407 

7879 

5 10:21:59 

hft/0 

0:00 


root@aix320: / >kill -9 6694 


ocsna -i occl 
grep ocsna 


usr/oc/bin/scaad 
usr/oc/bin/scaad 
usr/oc/bin/scaad 
grep scaad 


Figure 164. SCAAD and OCSNA Shutdown Sample 
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Chapter 18. OC/FTP Server Operation and Examples 


This chapter: 

• provides instructions on how to start and operate the OC/FTP Server at the 
VSE host side. 

• expiains how to initiate and execute fiie transfers from TCP/iP nodes to/from 
the VSE host. 

• gives exampies of fiie transfer operations that were tested in our 
environment. 


18.1 Operation 


This section describes how the OC/FTP Server is started and provides an 
overview of the commands. 


18.1.1 VSE Host (FTP Server) 

To start OC/FTP Server, the job described in Figure 47 on page 76 is used. 
Figure 165 beiow shows a sampie consoie iog after having started the OC/FTP 
Server. 


Zl 0045 // JOB FTPS 

DATE 07/05/96, CLOCK 11/29/41 

Zl 0045 FTPMOIOI : OPENCONNECT SYSTEMS VSE FTP SERVER V2 .F2 .M4 . T1 (206) 

Zl 0045 FTPC030I : CONFIG PROCESSING COMPLETE. 000 ERRORS. 

Zl 0045 FTPI020I : CPU ID 70001 IS REGISTERED AS PRIMARY. 

Zl 0045 FTPI040I : CPU ID 70001 IS ON TRIAL UNTIL 12/30/96. 

Zl 0045 FTPMIOOI : SERVER USING PORT NUMBER 00021 

Zl 0045 FTPN030W : ALL DEFAULT ALLOCATION VALUES WILL BE USED 

Zl 0087 FTPSOIOI : VTAM SESSION ESTABLISH TO LU IPFT2S9A 
Zl 0090 ftp> ACF verification for USRIO passed 


Figure 165. OC/FTP Server Startup Sample 


© Copyright IBM Corp. 1995, 1996 
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To communicate with the OC/FTP Server running in a dynamic partition enter the 
foilowing command at the VSE consoie: 


msg fx,data=cmd 

where fx is the partition name and cmd is one of the commands described in 
Tabie 9. 


Command 

Explanation 

? or help 

display help information on operation command. 

status 

display information about OC/FTP Server such as ACB name, trace 
status, logins. 

quiesce 

before shutting down the OC/FTP Server, operator lets current 
users complete their file transfer operation and disables further 
logins. 

trace,yes 

start tracing the OC/FTP Server global packets 

trace,no 

stop tracing the OC/FTP Server global packets 

netstat 

display the current users and connections status. 

stop 

immediate shutdown of the OC/FTP Server forcing the current 

users. 


Table 9. OC/FTP Server Host Side Commands 


Figure 166 beiow shows a sampie consoie iog after using the 'status' operator 
command. On the status display, the VTAM ACB name can be identified to which 
the OC/FTP Server is connected, whether trace was started or not, as well as the 
TCP/IP port number we assigned to OC/FTP Server. 


Zl-0045 FTP> ENTER COMMAND 
45 STATUS 

Z1 0045 FTPO130I : CURRENT FTP RUNTIME STATUS: 

Z1 0045 ACB NAME: OCSFTPS LOGINS: ENABLED 

Z1 0045 TRACE: NO 

Z1 0045 PORT: 00021 

Z1 0045 VERSION: V2.R2.M4.T1 (206) 

Z1 0045 FTPO130I : STATUS REQUEST COMPLETE. 


Figure 166. Console Log of Status Operation Command 


18.1.2 TCP/IP FTP Clients 

This section describes the commands that an FTP client can use. The standard 
TCP/IP FTP commands (GET, PUT and so on) will not be described, only the 
particular commands related to OC/FTP Server. For standard FTP commands 
refer to the appropriate documentation for your FTP Client (for example, TCP/IP 
V2.0 for OS/2 Command Reference, SX75-0070). 

OC/FTP Server lets users transfer files to three different subsystems within 
VSE/ESA: 

• VSAM (ESDS, KSDS and SAM) 
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• Librarian 


• POWER 

This is controiied via the SITE command described beiow. For sampies refer to 
section 18.2, “Operation Sampies” on page 226. 


18.1.2.1 SITE Command 

This command is used to set the appropriate subsystem environment vaiues for 
your FTP operation. The OC/FTP server site command is issued from an FTP 
Client and modifies the options of the OC/FTP Server SITE member "SITE.TCPIP". 
The command syntax is the following: 

quote site P1 P2 ....Pn 

where P1 P2 ....Pn are the parameter names followed by their values. For a 
short description of the SITE parameters, refer to Table 10 on page 222. For a 
detailed description of the SITE parameters, refer to Appendix I of the 
OpenConnect/FTP Client and FTP Server, VSE Installation and User's Guide 
350-0382-101.05. To enable the subsystem environment via the SITE command 
enter: 


quote site verify 

The access parameter is specified in a particular way. You only need to enter 
'SITE' followed by one of the following access modes (without specifying the 
access parameter): 

quote site vsam/vsamesd/vsamksd/vsamsam/vsesam/libr/user 

- Note - 

The access mode 'user' is for the User I/O exit routine. Please refer to 6.2.6, 
“User Exits” on page 79 for more information. 

The access mode 'vsesam' is for VSE non VSAM sequential operation. 
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Table 10 (Page 

1 of 3). OC/FTP Server Client Site Commands Summary 

Subsystem 

Parameter 

Explanation 

Generic 

Access 

Defines the access method for the current FTP 
operation. Acceptable values are: 

• VSAM/VSAMKSD/VSAMSAM/VSESAM 

• LIBR = for Librarian member 

• USER = User program (in this case you must 
specify an lOexit value) 


lOexit 

Specifies the name of a user written I/O exit 
routine 


XIate 

Selects the used translation table 

VSAM 

Adisp 

Specifies the VSAM abend disposition 


BIkfactor 

The value used for max (record/block) size 
calculation (default = 1) VSAM and VSESAM 
mode only. 


Bufndata 

Defines the VSAM buffer data number 


Bufnindex 

Only for VSAMKSD mode; defines the VSAM buffer 
index number 


Bufsp 

Defines the VSAM buffer space size 


Cafreespace 

Only for VSAMKSD mode; defines the Control 

Area free space for the VSAM file 


Catalog 

Specifies the filename of the used VSAM catalog 


Cdisp 

Specifies the VSAM close disposition 


Cifreespace 

Only for VSAMKSD mode; defines the Control 

Interval free space for the VSAM file 


CIsize 

Defines the Control Interval size of the VSAM files 


Cisizedata 

Defines the Control Interval size for the data part 
of VSAM file 


Cisizeindex 

Defines the Control Interval size for the index part 
of a VSAM/KSDS file 


Dsn 

Defines the data set name for receiving data set if 
none can be determined. VSAM mode only. 


Highkey 

Specifies a high key value for a keyrange transfer 
of a portion of a VSAM/KSDS data set 


Keylength 

Only for VSAMKSD mode; defines the VSAM KSDS 
file keylength used during file transfer 
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Table 10 (Page 

2 of 3). OC/FTP Server Client Site Commands Summary 

Subsystem 

Parameter 

Explanation 

VSAM 

Keylocation 

Only for VSAMKSD mode; defines the VSAM KSDS 
file key start location used during file transfer 
(begin from position 0) 


Lowkey 

Specifies a low key value for a keyrange transfer 
of a portion of a VSAM/KSDS data set 


Modelentry 

Defines the model data set used for current file 
transfer. Default is NULL (not used) 


Palloc 

Defines the primary VSAM record allocation 


RDK 

Only for VSAMKSD mode; defines the Replace 
Duplicate Keys option for KSDS file reinsertion. 

Usage is RDK ON or RDK OFF 


Recordcount 

Provide the ability to transfer part of a file. 

Specifies the number of records to transfer. Only 
for VSAM and VSESAM modes. 


RTB 

Defines the Remove Trailing Blanks option when 

VSE sends out a VSAM file. Usage is RTB ON or 

RTB OFF 


Salloc 

Defines the secondary VSAM record allocation 


Skipcount 

Defines the number of records skipped before 
doing the file transfer, only for VSAM and 

VSESAM. 


Share 

Defines the VSAM shareoption for VSAM file 


Units 

Defines the unit allocation used for VSAM file. The 

value can be CYL/TRK/REC 


VSAMrecfm 

Defines the VSAM record format for VSAM SAM 
files. The value can be FIXBLK, FIXUNB, VARBLK, 
VARUNB or UNDEF, only for VSAM and VSESAM. 


VSAMrecI 

Defines the maximum VSAM record length, only 
for VSAM and VSESAM. 

Librarian 

LIBRrecf 

Defines the LIBR record format parameter. Only 
two values are possible; 

• "R" = fixed record format 

• "B" = byte string format 


MBRtype 

Defines the default member type value if you don't 
specify one with the FTP command 


LIBRrecI 

Specifies the LIBR member record length 


Lib 

The default VSE library name when no target 
library is specified 


Slib 

The default VSE sublibrary name when no target 
sublibrary is specified 
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Table 10 (Page 

3 of 3). OC/FTP Server Client Site Commands Summary 

Subsystem 

Parameter 

Explanation 

POWER 

Copies 

Specifies the number of copies to create 


LSTclass 

Defines the default LIST class 


LSTform 

Specifies the LIST form number 


LSTpri 

Specifies the LIST priority 


LSTrecI 

Specifies the LIST record length 


PUNclass 

Defines the default PUNCH class 


PUNform 

Specifies the PUNCH form number 


PUNpri 

Specifies the PUNCH priority 


PUNrecI 

Specifies the PUNCH record length 


RDRclass 

Defines the default READER class 


RDRpri 

Specifies the READER priority 


RDRrecI 

Specifies the READER record length 


SYSid 

Defines the system id value (necessary when you 
have a shared spool environment) 


TABS 

Specifies the number of blank characters to 
substitute when FTP receives an ASCII horizontal 

tab command 


Upcase 

Converts the files sent to POWER queues to upper 

case 


18.1.2.2 CD and DIR Commands 

The Change Directory command establishes the Current Working Directory 
(CWD) and DIR displays Its contents. These work similar to the UNIX or DOS 
commands, however, since VSE/ESA has a different file organization within 
VSAM and the Librarian, semantics and syntax of the above commands are 
different. 

The OC/FTP Server identifies a Librarian member as follows: 

library.sublibrary.membername.membertype 
and a VSAM file with Its 'flleld' (the same format of the DLBL statement): 
for example, xxxxxxx.yyyyyyyy.zzzzzzz.wwww. 

Table 11 on page 225 contains the correct syntax and the results of these 
commands. 
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Subsystem 

Client command 
syntax 

OC/FTP Server response 

Librarian 

cd ftp 

The library ftp becomes the Current Working 
Directory 


cd ftp.serv 

The sublibrary ftp.serv becomes the CWD 


cd ..client 

The library ftp.client becomes the CWD 


dir 

Displays the contents of the CWD 


dir 'ftp' 

Displays the sublibraries of the ftp library 


dir 'ftp.client 

Displays the contents of the 'ftp.client 
sublibrary 


dir test.client 

Displays the member test.client (only the 
entry, not the contents!) 


dir test'.* 

Displays the members of the CWD whose 
names begin with test 

VSAM 

cd 'goofie' 

The qualifier goofie becomes the CWD (the 
catalog is chosen with the SITE command!) 


cd minnie 

The qualifier minnie is appended to the CWD 


cd ' 

The CWD is reset 


dir 

Displays the contents of the CWD 


Table 11. OC/FTP Server CD and DIR Commands 


18.1.2.3 POWER Command 

The OC/FTP Server power command allows an FTP Client to send commands to 
or obtain data from the VSE/POWER subsystem. The syntax is as follows: 

quote power xxxxxx 

where xxxxxx Is the VSE/POWER cemmand (for example, d rdr). For a complete 
list and more details of VSE/POWER commands please refer to VSE/POWER 
Administration and Operation, SC33-6571. 


18.1.2.4 PUT and GET VSE/POWER Queue Files 

The OC/FTP Server allews an FTP Client te send or retrieve data from 
VSE/POWER queues. The syntax of these commands is as follows: 

put filename $$RDR 

put filename $$PUN.jobname(.class) 

put filename $$LST.Jobname(.class) 


get $$RDR.jobname(.class)(.number)(.suffix) filename 
get $$PUN.Jobname(.class)(.number)(.suffix) filename 
get $$LST.jobname(.class)(.number)(.suffix) filename 

where: 

• filename Is the name of the FTP Client local file 

• jobname Is the name of the VSE/POWER jeb 
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• class is the class of the VSE/POWER job 

• number is the number of the VSE/POWER job 

• suffix is the suffix used for duplicated VSE/POWER jobnames 

— Note - 

The parameters in parenthesis are optional, but if you omit one of them a 
period must be entered. If you omit the class parameter, the default 
value from the SITE command is used. 


18.2 Operation Samples 

The following sections show a number of examples of how OC/FTP Server 
functions can be invoked from a TCP/IP client. 


18.2.1 Establish Connection to the OC/FTP Server 

Before you oan use any FTP commands you need to connect to OC/FTP Server. 
Figure 167 shows how a connection prooedure from an OS/2 2.3 FTP Client 
works. 


IBM TCP/IP for OS/2 - FTP Client ver 07:13:23 on Jun 12 1995 
ftp> open aix320 

Connected to aix320.itsc.ibm.com. 

220 VSE/ESA FTP Sern/er ( V2 .R2 .M4. T1 (206) by OpenConnect Systems ) ready 
Name (aix320) : pram 
331 Password required. 

Password: .... 

230 User logged in. 
ftp> 


Figure 167. OC/FTP Server Logon Sample 

• aix320 is the symbolic name assigned to the address of the OCS II Gateway. 
The name was resolved through the OS/2 2.3 Domain Name Server and a 
session is established with AIX. Refer to 7.2.4.11, “RESOLVER Member” on 
page 101 for resolving host names through a Domain Name Server. 

• user and password must match one of the values specified in VSE library 
member PASSWD.TCPIP (see Figure 44 on page 72). 

- For your information - 

Since we are using the TCP/IP standard FTP listen port (21) for OC/FTP 
Server, we don't need to specify a different port number on the FTP Open 
oommand (refer to 12.6, “Set up Alternative Ports for AIX TELNET and FTP 
Servers” on page 186). 
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18.2.2 Using SITE 

Figure 168 gives some examples how to use the SITE command for OC/FTP 
Server. The first 'quote site' command shows the default values of OC/FTP 
Server. The second one ('quote site VSAM....') establishes acoess to VSAM and 
changes two related parameters. The following 'quote site' command shows the 
results of the previous 'quote site VSAM' command. 

'quote site verify' is required to enable the subsystem environment set by the 
previous 'quote site' command. 

- Note - 

It is recommended that you enter the quote site command without any 
parameter in order to see the result of your ohanges before Issuing the quote 
site verify command. 


ftp> quote site 

202-Current site dependent parameters 


Access 

=> 

LIBR 

Xlate 

Catalog 

=> 

VSESPUC 

Share 

CIsizedata 

=> 

04096 

Palloc 

VSAMrecl 

=> 

00132 

Bufsp 

Cdisp 

=> 

K 

Adisp 

Bufnindex 

=> 

00001 

Blkfactor 

Keylength 

=> 

00000 

Cafreespace 

VSAMrecfm 

=> 

UNDER 

Skipcount 

MBRtype 

=> 

TCP IP 

LIBRrecl 

RDRrecl 

=> 

00080 

LSTrecl 

RDRclass 

=> 

0 

LSTclass 

RDRpri 

=> 

3 

LSTpri 

LSTforcn 

=> 


PUNform 

Sysid 

=> 

N 

Copies 

Restart 

=> 

OFF 


Modelentry 

=> 

NULL 


Lowkey 

=> 

NULL 


Highkey 

=> 

NULL 



202 End of parameters. 
ftp> 

ftp> quote site vsam vsamreclSO 

201 SITE command ready for VERIFY. 
ftp> 


=> 

FTPSXLTE 

lOexit 

=> 


=> 

2 

Units 

=> 

REC 

=> 

0001024 

Salloc 

=> 

0000512 

=> 

0000000 

Bufndata 

=> 

00000 

=> 

K 

CIsizeindex 

=> 

00000 

=> 

00001 

Keylocation 

=> 

00000 

=> 

00000 

Cifreespace 

=> 

00000 

=> 

00000000 

Recordcount 

=> 

00000000 

=> 

00080 

LIBRrecf 

=> 

R 

=> 

00132 

PUNrecl 

=> 

00080 

=> 

A 

PUNclass 

=> 

A 

=> 

3 

PUNpri 

=> 

3 

=> 


TABS 

=> 

08 

=> 

001 

Upcase 

=> 

YES 


Figure 168. Quote SITE Command Sample 
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ftp> quote site 

202-Current site dependent parameters. 


Access 

=> VSAMESD 

Xlate 

=> ETPSXLTE 

lOexit 

=> 


Catalog 

=> VSESPUC 

Share 

=> 2 

Units 

=> 

REC 

CIsizedata 

=> 04096 

Palloc 

=> 0001024 

Salloc 

=> 

0000512 

VSAMrecl 

=> 00080 

Bufsp 

=> 0000000 

Bufndata 

=> 

00000 

Cdisp 

=> K 

Adisp 

=> K 

CIsizeindex 

=> 

00000 

Bufnindex 

=> 00001 

Blkfactor 

=> 00001 

Keylocation 

=> 

00000 

Keylength 

=> 00000 

Cafreespace 

=> 00000 

Cifreespace 

=> 

00000 

VSAMrecfm 

=> UNDER 

Skipcount 

=> 00000000 

Recordcount 

=> 

00000000 

MBRtype 

=> TCPIP 

LIBRrecl 

=> 00080 

LIBRrecf 

=> 

R 

RDRrecl 

=> 00080 

LSTrecl 

=> 00132 

PUNrecl 

=> 

00080 

RDRclass 

=> 0 

LSTclass 

=> A 

PUNclass 

=> 

A 

RDRpri 

=> 3 

LSTpri 

=> 3 

PUNpri 

=> 

3 

LSTforcn 

=> 

PUNform 

=> 

TABS 

=> 

08 

Sysid 

=> N 

Copies 

=> 001 

Upcase 

=> 

YES 

Restart 

=> OEF 






Modelentry 

=> NULL 






Lowkey 

=> NULL 






Highkey 

=> NULL 







202 End of parameters. 
ftp> quote site verify 
200 SITE command okay. 
ftp> 


Figure 169. Quote SITE Verify Command Sample 


18.2.3 Switching/Displaying Libraries (Librarian) 

Figure 170 on page 229 show how to switch between different libraries and 
display the entire library or parts of it. Before using librarian commands, 
establish access to Librarian using the quote site libr command. 
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ftp> quote site libr 

201 SITE command ready for VERIFY. 

ftp> quote site 

202-Current site dependent parameters. 

Access => LIBR Xlate => ETPSXLTE lOexit 

Catalog => VSESPUC Share => 2 Units 

CIsizedata => 04096 Palloc => 0001000 Salloc 


ftp> quote site verify 
200 SITE command okay. 
ftp> cd tcpocs 
200 CWD command okay. 
ftp> pwd 

251 tTCPOCSt is current directory. 
ftp> cd tcpocs. ftpc 
200 CWD command okay. 
ftp> pwd 

251 tTCPOCS.ETPCt is current directory. 

ftp> cd ..usrl 

200 CWD command okay. 

ftp> pwd 

251 tTCPOCS.USRlt is current directory. 
ftp> dir 

200 PORT command okay. 

150 Opening data connection. 

SERVICES TCPIP 96-07-02 12:59.34 103 R 4 80 

AIXCON TXT 96-05-29 13:14.43 68 R 3 80 

ftp> dir <:tcpoCS<: 

200 PORT command okay. 

150 Opening data connection. 


TELC 

96-05-29 13:14.16 

622 

3504 

0 

0 I 

USRl 

96-05-29 13:14.43 

2 

8 

0 

0 A 

USRIO 

96-05-29 13:14.43 

0 

1 

0 

0 A 

USR2 

96-05-29 13:14.43 

0 

1 

0 

0 A 

USR3 

96-05-29 13:14.44 

0 

1 

0 

0 A 

USR4 

96-05-29 13:14.44 

0 

1 

0 

0 A 

USR5 

96-05-29 13:14.44 

0 

1 

0 

0 A 

USR6 

96-05-29 13:14.44 

0 

1 

0 

0 A 

USR7 

96-05-29 13:14.45 

0 

1 

0 

0 A 

USR8 

96-05-29 13:14.45 

0 

1 

0 

0 A 

USR9 

96-05-29 13:14.45 

0 

1 

0 

0 A 

LPD 

96-05-29 13:37.50 

37 

547 

0 

0 A 

PARMLIB 

96-06-17 13:37.50 

11 

185 

0 

0 A 

SAMMAC 

96-06-24 16:48.46 

176 

527 

0 

0 A 

SAMOBJ 

96-06-24 16:49.00 

101 

818 

0 

0 A 

SAMSMP 

96-06-24 16:49.19 

96 

647 

0 

0 A 


226 Transfer complete, 
remote: CtcpocsC 

1716 bytes received in 1.50 seconds (1 Kbytes/s) 


Figure 170 (Part 1 of 2). CD and DIR Librarian Command Samples 
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ftp> 

ftp> dir <:tcpocs .usrl<: 

200 PORT command okay. 

150 Opening data connection. 

..USRl.SERVICES TCPIP 96-07-0212:59.34 103 R 4 SON 

..USRl.AIXCON TXT 96-05-2913:14.43 68 R 3 SON 

226 Transfer complete, 
remote: Ctcpocs.usrlC 

160 bytes received in 0.22 seconds (0 Kbytes/s) 
ftp> 

ftp> dir aixcon.txt 
200 PORT command okay. 

150 Opening data connection. 

AIXCON TXT 96-05-29 13:14.43 68 R 3 80 N - 

226 Transfer complete, 
remote: aixcon.txt 

73 bytes received in 0.18 seconds (0 Kbytes/s) 
ftp> 

ftp> dir aix*.* 

200 PORT command okay. 

150 Opening data connection. 

AIXCON TXT 96-05-29 13:14.43 68 R 3 80 N - 

226 Transfer complete, 
remote: aix*.* 

73 bytes received in 0.19 seconds (0 Kbytes/s) 
ftp> 


Figure 170 (Part 2 of 2). CD and DIR Librarian Command Sampies 


18.2.4 Switching/Displaying VSAM Data Sets 

Figure 171 demonstrates the use of CD and DIR commands in the VSAM 
environment. Change access mode using the quote site vsam oommand. 


ftp> cd <:test<: 

200 CWD command okay. 
ftp> pwd 

251 tTESTt is current directory. 

ftp> cd ftp 

200 CWD command okay. 

ftp> pwd 

251 tTEST.FTPt is current directory. 
ftp> dir 

200 PORT command okay. 

150 Opening data connection. 

CLUSTER-TEST. FTP. CLIENT 

CLUSTER-TEST. FTP. SERVER 

226 Transfer conplete. 

66 bytes received in 14.02 seconds 
ftp> cd <:<: 

200 CWD command okay. 
ftp> pwd 

551 No valid working directory has been established. 


Figure 171. CD and DIR VSAM Command Samples 
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18.2.5 Accessing POWER 

Figure 172 shows how access to the POWER RDR queue is established. 


ftp> quote power d rdr,pa* 


214-1R46I 

READER QUEUE 

P 

D 

C S 

CARDS 


1R46I 

PAUSEPC 

01846 

3 

H 

0 

4 

FRCM=(USR2) 

1R46I 

PAUSEBG 

02530 

3 

L 

0 

4 

FRCM=(SYSA) 

1R46I 

PAUSEFl 

00024 

3 

L 

1 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF2 

00025 

3 

L 

2 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF3 

00026 

3 

L 

3 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF4 

00027 

3 

L 

4 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF5 

00028 

3 

L 

5 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF6 

00029 

3 

L 

6 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF7 

00030 

3 

L 

7 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF8 

00031 

3 

L 

8 

4 

FRCM=(SYSA) 

1R46I 

PAUSEF9 

00032 

3 

L 

9 

4 

FRCM=(SYSA) 

1R46I 

PAUSEFA 

00022 

3 

L 

S 

4 

FRCM=(SYSA) 

1R46I 

PAUSEFB 

00023 

3 

L 

T 

4 

FRCM=(SYSA) 


214 


Figure 172. POWER Command Sample 


18.2.6 Submitting a Job to VSE/ESA 

One of the standard requirements for customers is to manipulate VSE job 
streams using a workstation editor and to send them to VSE/ESA for execution. 

Figure 173 on page 232 shows an example of an AIX shell script ('vsesub') 
which we used to submit a VSE job file ('llstllb') to VSE/ESA. The shell sorlpt 
accepts one parameter (the jobname) as Input and transfers that job to the 
POWER reader queue using the FTP 'put' oommand. Figure 174 on page 232 
shows the VSE/ESA console log after the job was sent from AIX user 'PRAM'. 

- Note - 

To avoid the FTP login procedure, we coded a TCP/IP '.netrc' file whloh 
contains the login user ID and password for the FTP session. 

The '.netrc' file also Includes an FTP macro definition called 'sendjob'. This 
macro can be executed by preceding It with the '$' sign, that is 

ftp> $sendjob vsejob 

If the macro should be executed automatically after FTP login Its name must 
be ohanged to Init. 

For more Information on FTP macros refer to the TCP/IP related chapter in 
AIX Version 3.2 System User's Guide: Communications and Networks, 
GC23-2523. 
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/u/pram >cat .netrc 

machine aix320 21 login pram password pram 
macdef init 
quote power d rdr, free 

macdef sendjob 
put $1 $$RDR 

macdef listjob 
quote power d rdr, free 

/u/pram >ls -al vse* 

- 2 rwxr—r— 1 pram 

- 2 rwxr—r— 1 pram 

- 2 rwxr—r— 1 pram 

/u/pram > 

/u/pram >cat vsesub 
* keep old VSESUB 


/u/pram >ls -al listlib 

- 2 rw-r—r— 1 pram staff 113 Jul 17 07:57 listlib 

/u/pram >cat listlib 

* $$ job jnm=liblib,class=a 

// job listlib - listing library 
// exec libr, pa 2 nn=<:mshpC 
Id l=tcpocs 
/* 

/& 

* $$ eoj 
/u/pram > 

/u/pram >vsesub listlib 
Verbose mode on. 

200 PORT command okay. 

150 Opening data connection. 

226 Transfer complete. 

120 bytes sent in 0.002208 seconds (53.07 Kbytes/s) 

221 Goodbye. 

Sending job listlib to the VSE system ! 

/u/pram > 

/u/pram > 


staff 378 Jul 17 07:52 vsegetpr 

staff 289 Jul 17 07:52 vsepr 

staff 530 Jul 17 09:02 vsesub 


Figure 173. Submitting a Job to VSE/ESA POWER from AIX 


Z1 0088 ftp> ACE verification for PRAM passed 
BG 0001 1Q47I BG LIBLIB 04458 FROM (PRAM) , TIME=12:13:54 
BG 0000 // JOB LISTLIB - LISTING LIBRARY 
DATE 07/17/96, CLOCK 12/13/54 
BG 0000 // EXEC LIBR, PABM=tMSHP<: 

BG 0000 EOJ LISTLIB MAX.RETURN CODE=0000 

DATE 07/17/96, CLOCK 12/14/04,DURATION 00/00/09 
BG 0001 1Q34I BG WAITING FOR WORK 


Figure 174. VSE/ESA Console Log after Submitting a Job from AIX 
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18.2.7 Sending Print Lists to VSE/ESA 

Another common customer requirement is to use the host printer from LAN 
attached workstations. This can aiso be achieved by using the TCP/IP FTP 
faciiities, as shown in the exampie described beiow. 

Figure 175 shows a sheli script ('vsepr') which we used to send a fiie to VSE's 
POWER iist queue for printing. The sheii script accepts two parameters, the 
name of the fiie to be printed and the print ciass on VSE/ESA POWER. The sheii 
script transfers the fiie into the POWER list queue using again the FTP 'put' 
command. The owner of the resuiting POWER iist queue entry is the user who 
initiated the FTP fiie transfer for the print fiie ('PRAM' in our exampie, see 
Figure 176). 

Figure 176 shows the VSE/ESA consoie iog after the print fiie was sent from AIX 
user 'PRAM'. 


/u/pram >cat vsepr 

# accept inline command up to eof 

# toggle on the display mode 

# send the listing to VSE 

# quit the ftp session 

the VSE System for printing ! 

/u/pram >ls -al ocstst* 


#!/bin/ksh 

ftp aix320 21 « eof 

verbose on 

put $1 \$\$LST.$1.$2 

bye 

eof 

echo sent listing $1 to 


-rw-r- 1 pram staff 1825 Nov 18 14:25 ocststl 

-rw-r- 1 pram staff 2025 Jul 17 13:52 ocstst2 


/u/pram >vsepr ocststl p 


Verbose mode on. 

200 PORT command okay. 

150 Opening data connection. 

226 Transfer conplete. 

2050 bytes sent in 0.006686 seconds (299.4 Kbytes/s) 
221 Goodbye. 

sent listing ocststl to the VSE System for printing ! 


/u/pram > 


Figure 175. Sending a Print List to VSE/ESA POWER from AIX 


d 1st,*ocstst 

AR 0015 1C39I COMMAND PASSED TO VSE/POWER 
FI 0001 1R46I LIST QUEUE NOTHING TO DISPLAY 
Z1 0089 ftp> ACE verification for PRAM passed 
d 1st,*ocstst 

AR 0015 1C39I COMMAND PASSED TO VSE/POWER 

FI 0001 1R46I LIST QUEUE P D C S PAGES CC FORM 

FI 0001 1R46I OCSTSTl 04460 3 D P 11 FROM=(PRAM) 


Figure 176. VSE/ESA Console Log after Sending a Print List from AIX 
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18.2.8 Receiving Print Lists from VSE/ESA 

The FTP 'get' command can be used to transfer print lists from the VSE/ESA 
POWER list queue to remote TCP/IP nodes and print them at local printers. 

Figure 177 on page 235 shows two shell scripts, 'pwrlst' to display the POWER 
list queue entries and 'vsegetpr' to transfer print files from the POWER list queue 
to TCP/IP nodes for local printing. 

While 'pwrlst' requires only one parameter (the name or part of the name for the 
list queue entry), 'vsegetpr' needs three parameters (jobname, class and 
jobnumber). The shell script could also have asked for only two parameters, 
jobname and class, then FTP would always retrieve the oldest version of the 
entry. The olass parameter is always required. 
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/u/pram >cat pwrlst 


#!/bin/ksh 

ftp aix320 21 « eof # accept inline input up to end of file string 

verbose on # toggle on the display mode 

quote power d 1st, *$1 # display POWER LST Queue entries 

bye # quit the ftp session 

eof 

/u/pram >cat vsegetpr 
#!/bin/ksh 

ftp aix320 21 « eof # accept inline input up to end of file string 

verbose on # toggle on the display mode 

get \$\$LST.$1.$2.$3 $1 # get the file from list queue of VSE POWER 

bye # quit the ftp session 

eof 

Ipr $1 # print the file out to AIX local printer 

echo Job $1 retrieved from the VSE System for printing ! 


/u/pram >ls -al oc* 


~rw-r - 

1 pram 

staff 


2025 Oct 28 

15:59 ocs.test.ksds 

~rw-r - 

1 pram 

staff 


1825 Nov 18 

14:25 ocststl 

rw r 

1 pram 

staff 


2025 

Jul 17 

13:52 ocstst2 

-rw-r- 

1 pram 

staff 


1168 

Jul 17 

14:07 ocstst3 

/u/pram >pwrlst oc 






Verbose mode on. 






214-1R46I 

LIST QUEUE P D C 

S 

PAGES 

CC FORM 

1R46I 

OCSTSTl 

14293 3 D P 

1 

1 

1 

FROM= (PRAM) 

1R46I 

OCSTSTl 

14328 3 D P 

1 

1 

1 

FROM= (PRAM) 


214 

221 Goodbye. 

/u/pram >vsegetpr ocststl p 14293 

Verbose mode on. 

200 PORT command okay. 

150 Opening data connection. 

226 Transfer conplete. 

1850 bytes received in 0.03341 seconds (54.08 Kbytes/s) 
221 Goodbye. 

Job ocststl retrieved from the VSE System for printing ! 
/u/pram >ls -al oc* 


-rw-r- 1 pram staff 2025 Oct 28 15:59 ocs.test.ksds 

-rw-r- 1 pram staff 1825 Nov 18 14:32 ocststl 

-rw-r- 1 pram staff 2025 Oct 25 13:52 ocstst2 

-rw-r- 1 pram staff 1168 Nov 18 14:07 ocstst3 


/u/pram >lpstat 

Queue Dev Status Job Eiles User PP % Blks Op Rnte 


IpO IpO RUNNING 3 ocststl pram 0 100 21 1 

bsh bshde READY 

/u/pram > 


Figure 177. Receiving Print Lists from VSE/ESA POWER 
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18.2.9 Transferring Files to/from VSE/ESA 

File transfers from an AIX FTP client using 'get'/'mget' and 'put'/'mput' 
commands follows. 

Figure 178 shows the transfer from VSE Librarian members to the AIX client and 
back into the VSE library. 


ftp> quote site libr 

201 SITE coimiand ready for VERIFY. 

ftp> quote site verify 

200 SITE command okay. 

ftp> dir (ftcpocs .usrl<: 

200 PORT command okay. 

150 Opening data connection. 

..USRl.SERVICES TCPIP 96-07-0212:59.34 103 R 4 

..USRl.AIXCON TXT 96-05-2913:14.43 68 R 3 


226 Transfer complete. 
ftp> pwd 

551 No valid working directory has been established. 
ftp> cd tcpocs.usrl 
200 CWD command okay. 
ftp> 

ftp> get serrvices.tcpip 
200 PORT command okay. 

150 Opening data connection. 

226 Transfer coirplete. 

2853 bytes received in 0.3018 seconds (9.231 Kbytes/s) 
ftp> 

ftp> mget a* 
mget AIXCON.TXT? 

200 PORT command okay. 

150 Opening data connection. 

226 Transfer complete. 

2210 bytes received in 0.09886 seconds (21.83 Kbytes/s) 
ftp> 

ftp> get serm/ices. tcpip serm/ices. test 
200 PORT command okay. 

150 Opening data connection. 

226 Transfer coirplete. 

2853 bytes received in 0.1311 seconds (21.26 Kbytes/s) 
ftp> 

ftp> !Is 


AIXCON.TXT 

ocststl 

services.test 

trash 

AixtermLog.IacBm3 

ocstst2 

smit.log 

vsegetpr 

Power.dt 

ocstst3 

smit.script 

vsepr 

aixdata 

prereq 

sublist 

vsesub 

cache.f 

ptf 

test 

vsesubl 

info 

pwrlst 

test.a 

vsesub2 

listlib 

q 

test2 


mbox 

rmlpp 

test3 


ocs.test.ksds 

services.tcpip 

testmem.b 



ftp> 


80 N - 
80 N- 


Figure 178 (Part 1 of 2). Transfering Files to/from VSE/ESA from an AIX FTP Client 
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ftp> put test.a 

200 PORT command okay. 

150 Opening data connection. 

226 Transfer conplete. 

27 bytes sent in 0.03296 seconds (0.8 Kbytes/s) 
ftp> 

ftp> mput s* 

mput se 2 rvices.tcpip? 

200 PORT command okay. 

150 Opening data connection. 

226 Transfer conplete. 

2853 bytes sent in 0.008451 seconds (329.7 Kbytes/s) 
mput se 2 c/ices.test? 

200 PORT command okay. 

150 Opening data connection. 

226 Transfer conplete. 

2853 bytes sent in 0.007939 seconds (350.9 Kbytes/s) 

mput smit.log? n 

mput smit.script ? n 

mput sublist? n 

ftp> 

ftp> put services.test services.t 
200 PORT command okay. 

150 Opening data connection. 

226 Transfer conplete. 

2853 bytes sent in 0.007916 seconds (352 Kbytes/s) 
ftp> 

ftp> dir 

200 PORT command okay. 

150 Opening data connection. 


TEST A 

96-07-17 14:56.28 

3 R 

1 

80 N - 

SERVICES T 

96-07-17 14:58.26 

103 R 

4 

80 N - 

SERVICES TCP IP 

96-07-17 14:56.52 

103 R 

4 

80 N - 

SERVICES TEST 

96-07-17 14:57.07 

103 R 

4 

80 N - 

AIXCON TXT 

96-05-29 13:14.43 

68 R 

3 

80 N - 


226 Transfer conplete. 
ftp> 


Figure 178 (Part 2 of 2). 


Transfering Files to/from VSE/ESA from an AIX FTP Client 
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Chapter 19. OC/FTP Client Operation and Examples 

There are two ways to initiate fiie transfer operations from the VSE host: 

1. Using a batch job 

This requires that ali FTP commands have to be imbedded, in iogicai 
sequence, in the job. As shown in Figure 50 on page 85 the OC/FTP Ciient 
program then manages, together with VTAM, aii communications to the OCS 
li Gateway. 

2. Interactively using CiCS transaction ftp' 

This requires that the OC/FTP Ciient program has been started and is 
running in a dynamic partition. CICS ISC is used to pass aii interactive FTP 
commands to the OC/FTP Ciient program (see Figure 192 on page 262). 


19.1 FTP Client Command Summary 

For both modes of operation the FTP commands avaiiabie for VSE host users 
have the same format. The subsystem environment to which the fiie transfer 
operations appiy is defined in the DYNALL iibrary member (refer to Figure 53 on 
page 93) and can be adjusted via the defauits command. 

For a fuii description of the OC/FTP Ciient commands, piease refer to Appendix 
H of the OpenConnect/FTP Client and FTP Server, VSE Installation and User's 
Guide, 350-0382-101.05. 

Tabie 12 provides a summary of the OC/FTP Ciient commands. 


Table 12 (Page 1 of 7). OC/FTP Client Commands Summary 

Command 

Parameters 

Explanation 

append 

vsefile 
{TCP/I Pf He) 

The VSE file named vsefile is appended to the 
TCP/IPfile. If the second parameter is omitted, 
the file on the TCP/IP host is named vsefile 

ascii 


The file transfer will be in ASCII mode (default) 

binary 


The file transfer will be in binary mode 

bye 


The OC/FTP Client session with the TCP/IP FTP 

Server is closed and an exit from the OC/FTP 
Client is performed. It works in the same way 
as the quit command 

cd 

TCP/lPdirectory 

The TCP/lPdirectory becomes the Current 

Working Directory (CWD) 

close 


The OC/FTP Client session with the TCP/IP FTP 
Server is closed, but no exit from the OC/FTP 
Client is performed 

cIs 


The screen is cleared 

debug 


When you activate this option, OC/FTP Client 
prints every command sent to the TCP/IP host. 
The debug is set off by default 


© Copyright IBM Corp. 1995, 1996 
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Table 12 (Page 2 of 7). OC/FTP Client Commands Summary 

Command 

Parameters 

Explanation 

defaults 

BIkfactor number 

Used by the OC/FTP Client to calculate the 
maximum block or record size for a VSAM file 
depending on whether the record format is 
blocked or unblocked (default = 1) 


Bufndata number 

number becomes the default VSAM buffer data 
(BUFND) for the new VSAM file 


Bufnindex 

number 

number becomes the new default VSAM buffer 
index (BUFNI) for the new VSAM file (for VSAM 
KSDS only) 


Bufsp number 

number becomes the default VSAM buffer 
space (BUFSP) for the new VSAM file 


Cafreespace 

number 

number becomes the default VSAM CA free 
space (CAFREESPACE) for the new VSAM file 
(for VSAM KSDS only) 


Cifreespace 

number 

number becomes the default VSAM Cl free 
space (CIFREESPACE) for the new VSAM file 
(for VSAM KSDS only) 


Cisizedata 

number 

number becomes the default VSAM data 

CISIZE (CISIZE.DATA) for the new VSAM file 


Cisizeindex 

number 

number becomes the default VSAM index 

CISIZE (CISIZE.INDEX) for the new VSAM file 
(for VSAM KSDS only) 


cisdsp disposition 

The disposition becomes the new default VSAM 
file close disposition value (the possible values 
are the same which are used for the DISP = 
parameter of the VSE DLBL statement) 


Dsn datasetname 

The new default datasetname when the 
receiving data set name cannot be determined 


HALT 

Used to vary support ON, or OFF for OC/FTP 
Client to produce return codes whenever an 
error is experienced during FTP execution 


Highkey 

Specifies a high key value for a keyrange 
transfer of a portion of a VSAM/KSDS data set 


Keylength 

number 

The keylength for VSAM KSDS file transfer (if 
not specified, the value will be taken from 
default model (for VSAM KSDS only)) 


Keylocation 

number 

The start position of the key counting from 0 
(for VSAM KSDS only) 


lib libname 

The libname becomes the new default Library 
name value 
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Table 12 (Page 3 of 7). OC/FTP Client Commands Summary 

Command 

Parameters 

Explanation 

defaults 

list 

Displays the current vsefiie allocation 
characteristics contained in the defaults 

member 


Lowkey 

Specifies a low key value for a keyrange 
transfer of a portion of a VSAM/KSDS data set 


IrecI number 

The number becomes the new default VSAM 

maximum record size value 



• Mode LIBR Lrecl=80 when 

Recfm = RECORD 



• Mode VSAM for VSAMSAM, 
Lrecl*Blkfactor=Maxrecl 


mbrn mbrname 

The mbrname becomes the new default 

Librarian member name value 


mbrt mbrtype 

The mbrtype becomes the new default 

Librarian member type value 


mode libr vsam 

vsamesd vsamksd 

vsamsam 

Lets you choose the new subsystem 
environment for file transfers: 

• LIBR = ftp operations will affect the 

Librarian 



• VSAMESD = ftp operations will affect 
VSAMESDS files 



• VSAMKSD = ftp operations will affect 
VSAMKSDS files 



• VSAMSAM = ftp operations will affect 
VSAMSAM files 


Modelentry 

datasetname 

The name of the model data set instead of 
using the default model 


opendsp 

disposition 

The disposition becomes the new default VSAM 
file open disposition value (the possible values 
are the same ones that are used for the 

DISP= parameter of the VSE DLBL statement) 


palloc number 

The number becomes the new default VSAM 
file primary allocation value 


RDK 

Used only for VSAM/KSDS inbound transfers 
to VSE, this option denotes (R)eplace 
(D)uplicate (K)eys 


Recfm 

Specifies the record format for transfer data 
set definition to VSE. Only for LIBR, 

VSAMSAM, and VSESAM modes 


recordcount 

number 

The default threshold value for sending or 
receiving VSAM data set expressed in number 
of records 


retain number 

The number becomes the new default VSAM 
file retention period value (the number format 
is the same one that is used for the DATE = 
parameter of the VSE DLBL statement) 
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Table 12 (Page 4 of 7). OC/FTP Client Commands Summary 


Command 

Parameters 

Explanation 

defaults 

recfm type 

The default record format for files transferred 

in LiBR or VSAM mode 

• MODE LIBR 

- Recfm=RECORD - Fixed record 

- Recfm = BYTE - Variabie byte 

• MODE VSAMESD Recfm is not used 

• MODE VSAMKSD Recfm is not used 

• MODE VSAMSAM Recfm defauit is UNDEF 

- Recfm = FiXBLK - Fixed biocked 

- Recfm=FIXUNB - Fixed unbiocked 

- Recfm=VARBLK - Variabie biocked 

- Recfm=VARUNB - Variabie unbiocked 

- Recfm = UNDEF - Undefined 

RTB 

Used oniy for VSAM mode outbound transfers 
from VSE, denotes (R)emove (T)raiiing (B)ianks 

salloc number 

The number becomes the new defauit VSAM 
fiie secondary aiiocation vaiue 

share number 

The defauit shareoptions for the VSAM fiie 

skipcount number 

The defauit number of records to be skipped 
before starting the data transfer 

sllb slibname 

The slibname becomes the new defauit 
subiibrary name vaiue 

units cyl trk rec 

The defauit aiiocation unit during data transfer 

vsamcat catname 

The catname becomes the new defauit VSAM 
cataiog 

delete 

TCP/lPdirectory 

The TCP/lPdirectory wiii be deieted 

dir 

{TCP/lPdirectory) 

The iist of the TCP/lPdirectory wiii be printed, 
if you omit the parameter the iist of the CWD 
wiii be printed 

get 

MODE^LIBR 

TCP/IPfile 

(mbrname.mbrtype) 

The OC/FTP Ciient program gets the TCP/IPfile 
and puts it in a VSE iibrary with the specified 
member name and member type, if you omit 
the member attributes OC/FTP Ciient tries to 
use TCP/IPfile vaiue. if the name isn't 
compatibie with the VSE/ESA fiie naming 
conventions, the OC/FTP Ciient wiii then 
change this name for compiiance. The get 
command is equai to the recv command 

get 

MODE^VSAM 

TCP/IPfile 

(vsefUe) 

The OC/FTP Ciient program gets the TCP/IPfile 
and puts it in a VSAM data set created with 
the specified vsefile. If you omit the member 
attributes OC/FTP Ciient tries to use TCP/IPfile 
vaiue. if the name isn't compatibie with the 

VSAM fiie naming conventions, the OC/FTP 

Ciient wiii then change this name for 
compiiance 
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Table 12 (Page 5 of 7). OC/FTP Client Commands Summary 

Command 

Parameters 

Explanation 

help 

[command) 

The OC/FTP Client program displays the help 
about the specified command, if you omit the 
argument the OC/FTP Ciient dispiays a iist of 
the known commands, help command has the 
same meaning as the ? command. 

lappend 

TCP/IPfile 

[vsefile) 

The TCP/IPfile is appended at the end of the 
vsefile. This command is vaiid oniy for a 
sequentiai data set 

Idel 

(vsefUe) 

The named vsefile is deieted. if you omit the 
argument the CWD is deieted 

Idir 

(vsedir) 

The directory iisting of the named 
iibrary/cataiog is dispiayed. if you omit the 
argument the CWD is shown 

Is 

(TCP/I Pdir) 

Dispiays the contents of the TCP/lPdir. If you 
omit the argument the CWD is shown 

mget 

a1 (a2)....(an) 

Retrieves and transfers muitipie fiies from the 
TCP/iP to the VSE/ESA host (VSAM data set or 
subiibrary, depending on the MODE seiected). 
a1 (a2)....(an) are the fiie names seiected. 
Specifying means that you want to transfer 

aii fiies of the CWD. Remember, for 
MODE=VSAM, the dsn vaiue is considered the 
first quaiifier of a VSAM name (for exampie, 
with dsn=ftp.test, mget * wiii retrieve aii 
members named ftp.test.xxxxx.yyyyy) 

mkdir 

TCP/lPdir 

Creates a new directory on the TCP/IP host 

mkvsedir 

vsedir 

Creates a new sublibrary on the VSE/ESA host 

mput 

a1 (a2)....(an) 

Copies muitipie VSAM data sets or Librarian 
members from VSE/ESA to the TCP/iP host. a1 
(a2)....(an) are the fiie names seiected. 

Specifying means that you want to transfer 

aii fiies of the CWD. Remember, for 
MODE=VSAM, the dsn vaiue is considered the 
first quaiifier of a VSAM name (for exampie, 
with dsn=ftp.test, mput * wiii seiect aii VSAM 
fiies starting with 'ftp.test.') 

mputucase 


This option disabies the iower case option 
(defauit) of the fiie names used on an mput 
command 

open 

host / IPaddress 

Opens a connection to the named host or the 
IPaddress of the TCP/iP host, if you use the 
host the specified name must be present in the 
VSE HOSTS PARMLiB member 

pvsedir 


Dispiays the current working directory (CWD) 
of the VSE host 

prompt 


Enabies or disabies the interactive prompting 
used during mget/ mput operations to aiiow 
users to individuaiiy seiect the fiies to be 
transferred. If prompting is off, aii fiies of the 
CWD wiii be transferred 
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Table 12 (Page 6 of 7). OC/FTP Client Commands Summary 

Command 

Parameters 

Explanation 

put 

(vsefUe) 

The OC/FTP Client program gets and transfers 

MODE^LIBR 

TCP/IPfile 

the vsefUe to the CWD of the TCP/IP host with 
the specified TCP/IPname. If you omit the 
member attributes, OC/FTP Client tries to use 
TCP/IPfile value. If the name isn't compatible 
with the TCP/IP file naming conventions, the 
OC/FTP Client will then change this name for 
compliance. The put command is equal to the 
send command 

put 

(vsefUe) 

The OC/FTP Client program gets and transfers 

MODE^VSAM 

TCP/IPfile 

the vsefUe from a VSAM data set to the TCP/IP 
host CWD with the specified TCP/IPname. If 
you omit the member attributes, OC/FTP Client 
tries to use TCP/IPfile value. If the name isn't 
compatible with the TCP/IP file naming 
conventions, the OC/FTP Client will then 
change this name for compliance 

pwd 


Displays the name of the TCP/IP CWD 

quit 


See the bye command 

quote 

itemi 

Send a command [itemi) from VSE/ESA to the 


(item2)...(itemn) 

TCP/IP host 

recv 

TCP/IPfile 

(vsefUe) 

See the get command 

rename 

oldfile newfile 

Not supported by the OC/FTP Server for VSE 

rmdir 

TCP/lPdir 

Deletes the CWD on the TCP/IP host 

rmvsedir 

vsedir 

Deletes the current sublibrary on the VSE/ESA 
host 

send 

vsefUe 

(TCP/IPfile) 

See the put command 

setdfname 

(domain name 

Sets, if specified, the Domain name suffix that 


suffix) 

will be appended to the host name. If you omit 
the parameter the value will be cleared 

setnet 

network name 

Sets the Network name of the OC Server. The 

name has to match one of the names 

contained in the VSE PARMLIB member 

NETWORKS 

status 


Displays the current status of OC/FTP Client 

struct 

(t1) 

Sends the file type information to the FTP 

Server: 

• f = set the file structure to file 

• r = set the file structure to record 

If you omit the parameter the current structure 
will be displayed 

tcp/iphelp 

(commandname) 

The OC/FTP Client program displays the help 
information about the specified command. If 
you omit the argument the FTP Server shows a 
list of available commands 

tenex 


The file transfer type is set to tenex to enable 
communication with Tenex machines 

time 


Displays the current time and date 
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Table 12 (Page 7 of 7). OC/FTP Client Commands Summary 

Command 

Parameters 

Explanation 

trace 


When you activate this option, OC/FTP Client 
records the packet tracing to the 
userid.syslog.data. The trace is set off by 
default 

type 

(t1) 

Sends the file transfer type information to the 

FTP Server: 

• ascii = set the file transfer type to ASCII 

• binary = set the file transfer type to 
binary 

• image = set the file transfer type to image 
(same as binary) 

• tenex = set the file transfer type to TENEX 

If you omit the parameter the current file 
transfer type is displayed 

user 


OC/FTP Client prompts you for the user ID and 
password for the FTP Server. This is usually 
done when communication to the TCP/IP host 
is established, unless you start with autologin 
disabled 

verbose 


When verbose is ON (default) all responses 
sent by the TCP/IP host are displayed, 
including statistical values after file transfer 
operations 

vsecd 

vsedirectory 

The vsedirectory becomes the VSE CWD 

? 

(command) 

See the help command 


19.2 Batch Operation Samples 

The following examples show the jobs and output listings of file transfer 
operations from TCP/IP DOS and AIX nodes. An example of OS/2 2.1 directory 
operations is also provided. 


19.2.1 Get a File from PC/DOS to VSE Library 

The figures in this section show the FTP client batch job and its corresponding 
output listings when a file {'TEST.TXT') Is transferred from a workstation running 
Windows to VSE/ESA. 

TCP/IP for PC/DOS Windows (node TCPCL3, see Figure 13 on page 34) has a 
FTP Daemon (Server) running as a background task. 

Note that this example also shows the use of our Domain Name Server 
(TCPCL1). Figure 179 on page 246 shows the batch job we used to get a file 
from PC/DOS into the VSE library and Figure 180 on page 246 shows the output 
produced by the job. 
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* $$ JOB JNiy^FTPCBAT, CLASS=Y, DISP=D 
// JOB FTPCBAT 

// OPTION NOLOG,NOSYSDUyP,JCANCEL 
// LIBDEF *,SEARCH=(TCPOCS.FTPC) 

// EXEC FTPC, SIZE= (FTPC, 256K) 

OPEN TCPCL3 

pram 

jack 

PWD 

PVSEDIR 

LS 

GET TEST.TXT 
LOIR 
BYE 
/* 

/& 

* $$ EOJ 


Figure 179. VSE/ESA FTP Client Batch Job Example: Get a File from Windows 


// JOB FTPCBAT DATE 07/08/96, CLOCK 13/28/27 

// OPTION NOLOG,NOSYSDUyP,JCANCEL 

OpenConnect Systems, VSE FTP Client V2.R2.M4.T1 (206) Task=21 
Cpu id 70001 is registered as primary. 

Cpu id 70001 is on trial until 12/30/96. 
ftp> ACF verification for CunknwnC passed 

ftp> Initializing LIBR local directory, press Center^ to continue 
ftp> LIBR path now: TCPOCS.USER VSE.TCPOCS.LIBRARY 

Figure 180 (Part 1 of 3). FTP Client Batch Job Example Output: Get a File from Windows 
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ftp> OPEN TCPCL3 


Attertpting to establish a connection with domain name server : 
TCPCLl.ITSC.IBM.COyi (192.61.100.83 ) 

Time out. Retrying connection. 

Host name resolved through domain name server: 
TCPCLl.ITSC.IBM.COyi (192.61.100.83 ) 

TCP Trying 192.61.100.199 

Vtam connection established to Lu/Port IPFT2S9B 
Connected to TCPCL3. ITSC. IBM.CCM 

220 tcpcl3 FTP server (2.2.4.1) ready. 

Name: 
ftp> pram 

Password: 

331 Password required for pram. 

230 User pram logged in. 

ftp> ID=pram IP=192.61.100.199 LU=IPFT2S9B 
ftp> PWD 

257 tC:\t is current directory. 
ftp> PVSEDIR 

ftp> LIBR path is: TCPCCS.USER VSE.TCPCCS.LIBRARY 

ftp> LS 

200 PCRT command successful. 

150 Opening ASCII mode data connection for C:\*.*. 

C:\CayiMAND.CCM 

C:\WINA20.386 

C:\CONFIG.OLD 

C:\AUTOEXEC.OLD 

C:\CONFIG.SYS 

C:\AUTOEXEC.BAT 

C:\AUTOEXEC.BK 

C:\AUTOEXEC.BK2 

C:\CONFIG.BK4 

C:\AUTOEXEC.BK3 

C:\C0NFIG.BK1 

C:\AUTOEXEC.BK4 

C:\AUT0EXEC.BK1 

C:\CONFIG.BK2 

C:\CONFIG.BK3 

C:\TEST.TXT 

226 Transfer complete. 

252 BYTES received in 0 SECONDS (0.00 KBYTES/S) 


Figure 180 (Part 2 of 3). FTP Client Batch Job Exampie Output: Get a Fiie from Windows 
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ftp> GET TEST.TXT 

200 PORT conmand successful. 

150 Opening ASCII mode data connection for TEST.TXT (61 bytes) . 
ftp> ID=pram IP=192.61.100.199 LU=IPFT2S9B 

ftp> ID=pram DN=TCPOCS.USER 

ftp> ID=pram MN=TEST. TXT RQ=GET OD=N/A CD=N/A 

226 Transfer complete. 

60 BYTES received in 0 SECONDS (0.00 KBYTES/S) 
ftp> ID=pram BC 60 RC 1 


ftp> LDIR 
TEST A 
TCPAPPL B 
TESTMEM B 


96-05-04 15:12.14 
95-07-06 09:52.20 
95-07-06 09:19.22 


0000003 

0000089 

0000089 


OCSTESTV Z 96-05-0415:00.50 0000004 

directory request successful 

ftp> BYE 

ftp> ID=pram IP=192.61.100.199 LU=IPFT2S9B 
221 Goodbye. 


Figure 180 (Part 3 of 3). FTP Client Batch Job Example Output: Get a File from Windows 


19.2.2 Send a VSE/VSAM KSDS File to AIX 

In this example, we first defined a VSAM KSDS fiie, ioaded it with some sampie 
data of 25 records and sent it to AIX. 

- Note - 

When this exampie was created, the OC/FTP Server was using port number 
2071 and the AiX FTP Server the TCP/IP standard FTP port 21. Therefore, 
when no port number is specified in the FTP Open subcommand, the target 
FTP server wili be the one of the AIX system. Also, no resolver file has been 
created for AIX to use the Domain Name system. 


Figure 181 on page 249 shows the job we used to define a VSAM KSDS file. 

Figure 182 on page 250 shows the job to load and print the file. Finally, 

Figure 183 on page 251 shows the job and Figure 184 on page 252 its output for 

the VSE/ESA FTP Client file transfer operation. 
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* $$ JOB JNiy^DEFKSDS,CLASS=0,DISP=D 

// JOB DEFKSDS - DEFINE A VSAM KSDS FILE 
// EXEC IDCAMS, SIZE=AUTO 
DEFINE CLUSTER { NAME (OCS.TEST.KSDS) - 
CYLINDERS (11)- 
SHAREOPTIONS (2) - 
RECORDSIZE (80 80) - 

VOLUMES (SYSWK4) - 
NOREUSE - 
INDEXED - 

FREESPACE (15 7) - 
KEYS (5 0) - 
TO (99366)) - 

DATA (NAME (OCS.TEST.KSDS.DATA) - 
CONTROLINTERVALSIZE (4096)) - 
INDEX (NAME (OCS.TEST.KSDS.INDEX)) - 
CATALOG (TCPIP.USER.CATALOG) 

IF LASTCC NE 0 THEN CANCEL JOB 

/* 

// DLBL OCSTST,<:OCS.TEST.KSDS9,,VSAM,CAT=TCPCAT 
/* 

// EXEC lESVCLUP,SIZE=AUTO 

A OCS. TEST. KSDS OCSTST TCPCAT 

/* 

/& 

* $$ EOJ 


Figure 181. Define and Initiaiize a VSAM KSDS Fiie 

The file's record length is 80 and keylength is 5 starting from position 0. 
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* $$ JOB JNM=LOADKSDS,CIASS=A,DISP=D,NTFY=YES 
// JOB LOADKSDS - LOAD FILE FROM ICCF MEMBER 
// DLBL LOADFL, COOS. TEST. KSDS<:,,VSAM,CAT=TCPCAT 
// EXEC lESVSMLD,SIZE=AUTO 
80,K,LOADFL 


OOOOIPARTI 

00002PART2 

00003PART3 

00004PART4 

00005PART5 

00006PART6 

00007PART7 

00008PART8 

00009PART9 

OOOIOPARTIO 

OOOllPARTll 

00012PART12 

00013PART13 

00014PART14 

00015PART15 

00016PART16 

00017PART17 

00018PART18 

00019PART19 

00020PART20 

00021PART21 

00022PART22 

00023PART23 

00024PART24 

00025PART25 

/* 

// EXEC IDCAMS,SIZE=AUTO 
PRINT INFILE (LOADFL) 

/* 

/& 

* $$ EOJ 


000500I0000000503000239AAAAAAAAAAAAAAAAAAAAAAAA 

00060005000050002000239BBBBBBBBBBBBBBBBBBBBBBBB 

000I0003000000602000239CCCCCCCCCCCCCCCCCCCCCCCC 

00020040000050003000239DDDDDDDDDDDDDDDDDDDDDDDD 


0004000500000060I000239GGGGGGGGGGGGGGGGGGGGGGGG 

000I002000000080I000239HHHHHHHHHHHHHHHHHHHHHHHH 

0000500080000070I000239IIIIIIIIIIIIIIIIIIIIIIII 

0000507000000670I000239JJJJJJJJJJJJJJJJJJJJJJJJ 

000300I000000070I200039KfTTTTTTTCKKKKKKKKKKKKKKK 

nnni 0008000057002000239 1 ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T ,T, 

00020007000078003000239Myiyiyiyiyiyiyiyiyi^^ 

00020003000000703000239NNNNNNNNNNNNNNNNNNNNNNNN 

00010040000056704000239000000000000000000000000 

0000500500000Q004000239PPPPPPPPPPPPPPPPPPPPPPPP 

00060005000005004000239QQQQQQQQQQQQQQQQQQQQQQQQ 

0007000800005670I000239RRRRRRRRRRRRRRRRRRRRRRRR 

0000300500007000I000239SSSSSSSSSSSSSSSSSSSSSSSS 


000200I000000670I000239UUUUUUUUUUUUUUUUUUUUUUUU 

0008I0I0000035003003239VVVVVVVVVVVVVVVVVVVVVVW 

000060I000000200I003239M««««««««««««^^ 

000I00I000002I003000239XXXXXXXXXXXXXXXXXXXXXXXX 

0000I0I099003500I003239YYYYYYYYYYYYYYYYYYYYYYYY 


CHARACTER 


Figure 182. Load and Print the VSAM KSDS File 


Notice that the first five bytes wiii be the key of each record. 
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* $$ JOB JNiy^FTPCBAT,CLASS=0,DISP=D 
// JOB FTPCBAT 

// OPTION NOLOG,NOSYSDUyP,JCANCEL 
// LIBDEF *,SEARCH=TCPOCS.FTPC 
// EXEC FTPC, SIZE= (FTPC, 256K) 

OPEN AIX320 

pram 

jack 

DEFAULT MODE VSAMKSD 
PUT DCS.test.ksds 
DIR 
BYE 
/* 

/& 

* $$ EOJ 


Figure 183. Job to Transfer a VSAM KSDS File to AIX 

If current working directory (CWD) is not set, it's going to use the VSAMCAT 
parm in the defauit iist. 
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// JOB FTPCBAT DATE 07/09/96, CLOCK 15/53/33 

// OPTION NOLOG, NOSYSDUMP,JCANCEL 
OpenConnect Systems, VSE FTP Client V2.R2.M4.T1 (206) Task=21 
Cpu id 70001 is registered as primary. 

Cpu id 70001 is on trial until 12/30/96. 
ftp> ACF verification for 9unknwn9 passed 

ftp> Initializing LIBR local directory, press 9enter9 to continue 
ftp> LIBR path now: TCPOCS.USER VSE.TCPOCS.LIBRARY 

ftp> OPEN AIX320 

TCP Trying 192.61.100.81 

Vtam connection established to Lu/Port IPFT2S9B 
Connected to AIX320 

220 aix320 FTP server (Version 4.9 Thu Sep 2 20:35:07 CDT 1993) ready. 

Name: 

ftp> pram 

Password: 

331 Password required for pram. 

230 User pram logged in. 

ftp> ID=pram IP=192.61.100.81 LU=IPFT2S9B 

ftp> DEFAULT MODE VSAMKSD 

Defaults command completed successfully 

ftp> PUT ocs. test. ksds 

200 PORT command successful. 

150 Opening data connection for ocs. test. ksds. 
ftp> ID=pram IP=192.61.100.81 LU=IPFT2S9B 

ftp> ID=pram DN=OCS.TEST.KSDS 

ftp> ID=pram MN=N/A RQ=PUT ODOLD CD=KEEP 

226 Transfer complete. 

2050 BYTES sent in 0 SECONDS (0.00 KBYTES/S) 
ftp> ID=pram BC =2,050 R C 25 

ftp> DIR 

200 PORT command successful. 

150 Opening data connection for /bin/ls. 


total 88 




rw r 

1 pram 

staff 

2025 Jul 15 15:45 OCS.TEST.KSDS 

drwxr-xr-x 

3 pram 

staff 

512 Jul 15 14:00 info 

-rw-r—r— 

1 root 

system 

14 Jul 15 15:57 test3 

226 Transfer complete. 




707 BYTES received in 0 SECONDS (0.00 KBYTES/S) 
ftp> BYE 

ftp> ID=pram IP=192.61.100.81 LU=IPFT2S9B 
221 Goodbye. 

Figure 184. VSE/ESA FTP Client Batch Example: Send a VSAM KSDS File to AIX 

The VSAM KSDS file is stored in AIX as a byte stream with a byte containing 
hexadecimal 'Oa' after each record. There are 25 records of 80 byte characters 
(including blanks = 2000 bytes), and the FTP file transfer shows that 2050 bytes 
were sent. An AIX file list shows only 2025 bytes. This is due to the fact that most 
hosts use two control characters for the end of record indication; AIX, however 
only uses one ('Oa')- 
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The VSE host sends hexadecimal characters '0d15' for <CR> and <LF>. 
Personal computers use 'OdOa' for <CR> and <NL> (see the EBCDIC 
translation table where a hexadecimal '15' Is translated Into hexadecimal ASCII 
'Oa'). When a session is established to a host, the OpenConnect/File Transfer 
Program distinguishes between workstations (PCs and UNIX-based) and the host 
and provides for the necessary translation of subject control characters. 

Also keep in mind that VSE files are record oriented, that means, these control 
characters don't have to be Imbedded In your file. 

PC and AIX files, on the other hand, are byte oriented and require subject 
control characters. 


19.2.3 Sending a VSE/VSAM SAM File to AIX 

In this example, we first defined a VSAM SAM file. Then, we loaded the file with 
four records before we sent it to AIX using FTP 'put'. 

- Note - 

When this example was created, our OC/FTP Server used port number 2071 
and the AIX FTP Server used TCP/IP standard FTP port 21. Therefore, when 
no port number Is specified In the FTP Open subcommand, the AIX FTP 
server Is addressed. Also, the resolver file was not created In AIX to use the 
Domain Name system. 


Figure 185 on page 254 shows the job to define and initialize a VSAM SAM file. 
Figure 186 on page 254 and Figure 187 on page 255 show the job and output to 
load and print the file. Figure 188 on page 256 and Figure 189 on page 257 
show the job and output to send the VSAM SAM file to AIX. 
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* $$ JOB JNiy^DEFSAM,CLASS=0,DISP=D,NTFY=YES 

// JOB PRAM DEFINE FILE 

// EXEC IDCAMS, SIZE=AUTO 
DEFINE CLUSTER { - 

NAME (OCS.TEST.VSAMSAM) - 
CYLINDERS(I I) - 
SHAREOPTIONS (2) - 
RECORDSIZE (80 80) - 
RECORDFORMAT (FIXBLK (80) ) - 
VOLUMES (SYSWK4) - 
NOREUSE - 
NONINDEXED - 
FREESPACE (15 7) - 
TO (99366)) - 

DATA (NAME (CCS.TEST.VSAMSAM.@D@) - 
CONTROLINTERVALSIZE (4096)) - 
CATALOG (TCPIP.USER.CATALOG) 

IF LASTCC NE 0 THEN CANCEL JOB 

/* 

/ / DLBL OCSSAM, COCS. TEST. VSAMSAMC,, VSAM, C 

CAT=TCPCAT 

/* 

// EXEC lESVCLUP,SIZE=AUTO 

A OCS. TEST. VSAMSAM OCSSAM TCPCAT 

/* 

/& 

* $$ EOJ 


Figure 185. Define and initiaiize a VSAM SAM File 

The file's record length is 80 bytes and the record format is FIXBLK. 


* $$ JOB JNiy^LOADSAM,CLASS=A,DISP=D,NTFY=YES 

// JOB LOADSAM - LOAD DATA FROM SYSIPT INTO VSAMSAM FILE 
// DLBL LOADFL,<:OCS.TEST.VSAMSAMC,,VSAM,CAT=TCPCAT 
// EXEC IDCAMS, SIZE=AUTO 
REPRO INFILE(SYSIPT) - 
OUTF IT F, (LOADFL) 

PRAMOT HEMSTAPAT 
KLAUS DIETER WACKER 
KLAUS MARUSCHKA 
WERNER STIEBER 
/* 

// EXEC IDCAMS, SIZE=AUTO 
PRINT INFILE (loadFL) - 
CHARACTER 

/* 

/& 

* $$ EOJ 


Figure 186. Load and Print the VSAM SAM Fiie 
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//JOB LQADSAM DATE 07/08/96,CLOCK 08/46/51 

// DLBL LOADFL,<:OCS.TEST.VSAMSAM<:,,VSAM,CAT=TCPCAT 
// EXEC IDCAMS, SIZE=AUTO 

IDCAMS SYSTEM SERVTCES 

REPRO INFTLE(SYSTPT) - 
OUTETTE (LOADFL) 

TDC0005T NUMBER OF RECORDS PROCESSED WAS 4 

TDCOOOIT FUNCTION COMPLETED, HIGHEST CONDITION CODE WAS 0 

IDC0002I IDCAMS PROCESSING CCMPLETE. MAXIMUM CONDITION CODE WAS 0 
1S55I LAST RETURN CODE WAS 0000 
// EXEC IDCAMS, SIZE=AUTO 

IDCAMS SYSTEM SERVICES 

PRINT INFILE (LOADFL) - 
CHARACTER 

IDCAMS SYSTEM SERVICES 

LISTING OF DATA SET -OCS.TEST.VSAMSAM 

REA OF RECORD - 0 

PRAMOT HEMSTAPAT 

RBA OF RECORD - 80 

KLAUS DIETER WACKER 

RBA OF RECORD - 160 

KLAUS MARUSCHKA 

RBA OF RECORD - 240 

WERNER STIEBER 

IDC0005I NUMBER OF RECORDS PROCESSED WAS 4 

IDCOOOII FUNCTION COMPLETED, HIGHEST CONDITION CODE WAS 0 

IDCAMS SYSTEM SERVICES 

IDC0002I IDCAMS PROCESSING CCMPLETE. MAXIMUM CONDITION CODE WAS 0 
1S55I LAST RETURN CODE WAS 0000 

EOJLOADSAM DATE 07/08/96,CLOCK 08/47/09,DURATION 00/00/17 


Figure 187. Load and Print VSAM SAM File Output 
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* $$ JOB JNiy^FTPCBAT,CLASS=0,DISP=D 
// JOB FTPCBAT 

// OPTION NOLOG,NOSYSDUyP,JCANCEL 
// LIBDEF *,SEARCH=TCPOCS.FTPC 
// EXEC FTPC, SIZE= (FTPC, 256K) 

OPEN AIX320 

pram 

jack 

DEFAULT MODE VSAMSAM RECFM FIXBLK LRECL 80 RTB ON 

VSECD TCPCAT 

LDIR 

DIR 

STATUS 

PUT ocs.test.vsamsam 
DIR 
BYE 
/* 

/& 

* $$ EOJ 


Figure 188. Send a VSAM SAM File from a VSE/ESA FTP Client to AIX 

When sending the VSAM SAM file, we had to change the default mode to 
'VSAMSAM', and recfm and IrecI had to be specified. For VSAM outbound 
transfers we enabled the Remove Trailing Blanks (RTB) option to eliminate 
trailing blanks in each record. 
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// JOB FTPCBAT DATE 07/08/96, CLOCK 13/59/45 

// OPTION NOLOG,NOSYSDUyP,JCANCEL 

OpenConnect Systems, VSE FTP Client V2.R2.M4.T1 (206) Task=21 


Cpu id 70001 is registered as primary. 
Cpu id 70001 is on trial until 12/30/96. 


ftp> ACF verification for CunknwnC passed 

ftp> Initializing LIBR local directory, press Center^ to continue 
ftp> LIBR path now: TCPOCS.USER VSE.TCPOCS.LIBRARY 

ftp> OPEN AIX320 


TCP Trying 192.61.100.81 

Vtam connection established to Lu/Port IPFT2S9B 
Connected to AIX320 


220 aix320 FTP server (Version 4.9 Thu Sep 02 20:35:07 CDT 1993) ready. 

Name: 

ftp> pram 

Password: 

331 Password required for pram. 

230 User pram logged in. 

ftp> ID=pram IP=192.61.100.81 LU=IPFT2S9B 
ftp> DEFAULT MODE VSAMSAM RECFM FIXBLK LRECL 80 RTB ON 
Defaults command completed successfully 
ftp> VSECD TCPCAT 

ftp> VS74yiS74yi path now: TCPCAT TCP IP. USER. CATALOG 

ftp> LDIR 
AAAAAAAA.BBBBBB 
AIXDATA.KSDS 
AIXDATA.VSAMSTyj 


VTMBK.Bl 

VTMBK.B2 

CTCPCATC directory request successful 


Figure 189 (Part 1 of 2). Output of FTP Client Send VSAM SAM File to AIX Operation 
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ftp> DIR 

200 PORT conmand successful. 

150 Opening data connection for /bin/ls. 

226 Transfer complete, 
total 104 

-rvi-r - 1 staff 2025 Jul 15 15:45 OCS. TEST.KSDS 

-rw-r- 1 staff 0 Jul 15 17:48 OCS.TEST2.KSDS 

- 2 rw-r- 1 staff 2025 Jul 15 17:50 aixdata 


-rw-r—r— 1 system 27 Jul 15 15:57 test2 

-rw-r—r— 1 system 14 Jul 15 15:57 testS 

111 BYTES received in 0 SECONDS (0.00 KBYTES/S) 

ftp> STATUS 
Connected to AIX320 

Vse execution - Partition (BG) - Task (21) 

Type: ASCII ; Structure: FILE ; Verbose: ON 
Prompting: ON ; Debugging: OFF; Tracing: OFF 
Current VSE working directory: TCPCAT 
Current Dormain name server default name suffix: 

ftp> PUT OCS . test. vsamsam 

200 PORT command successful. 

150 Opening data connection for ocs.test.vsamsam. 
ftp> ID=pram IP=192.61.100.81 LU=IPFT2S9B 

ftp> ID=pram DN=OCS.TEST.VSAMSAM 

ftp> ID=pram MN=N/A RQ=PUT OD=OLD CD=KEEP 

226 Transfer complete. 

72 BYTES sent in 0 SECONDS (0.00 KBYTES/S) 
ftp> ID=pram BC 72 RC 4 

ftp> DIR 

200 PORT command successful. 

150 Opening data connection for /bin/ls. 
total 112 

-rw-r- 1 staff 2025 Jul 15 15:45 OCS. TEST.KSDS 

-rw-r- 1 staff 0 Jul 15 17:48 OCS.TEST2.KSDS 

-rw-r- 1 staff 2025 Jul 15 17:50 aixdata 


-rw-r—r— 1 system 27 Jul 15 15:57 test2 

-rw-r—r— 1 system 14 Jul 15 15:57 testS 

226 Transfer complete. 

840 BYTES received in 1 SECONDS (0.82 KBYTES/S) 
ftp> BYE 

ftp> ID=pram IP=192.61.100.81 LU=IPFT2S9B 
221 Goodbye. 

Figure 189 (Part 2 of 2). Output of FTP Client Send VSAM SAM File to AIX Operation 

The FTP file transfer shows that 72 bytes were transferred and appear as 68 
bytes in AIX due to the control character elimination (that is, one byte less for 
each of the four records). Also, since RTB (Remove Trailing Blanks) was set to 
'ON' all trailing blanks were eliminated in each record. 
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19.2.4 Remote Directory Operations 

The example shown in this section demonstrates how to use the OC/FTP Client 
for manipulating directories on remote TCP/IP nodes from VSE/ESA. Figure 190 
shows the job we used for directory operations on an OS/2 2.1 node and 
Figure 191 on page 260 lists the corresponding output of the OC/FTP Client 
batch job. 

The example also shows how host names are resolved using our OS/2 2.1 
Domain Name Server TCPCL1. 


* $$ JOB JNiyh=FTPCBAT,CLASS=0,DISP=D 
// JOB FTPCBAT 

// OPTION NOLOG,NOSYSDUyP,JCANCEL 

// DLBL OC.S, CVSF,. TOPOO.S. T JB RARYC,, VSAM, OAT=T JSY.SOT 

// LIBDEF *,SEARCH=(TCPOCS.FTPC) 

// EXEC FTPC, SIZE= (FTPC, 256K) 

OPEN TCPCLl 
pram 
jack 
VSECD 

DEFAULTS MODE LIBR LIB TCPOCS 

VSECD .USRl 

PWD 

MKDIR C: \TCPIP\FTPC 
RMDIR C: \TCPIP\FTPC 
MKVSEDIR TCPOCS.FTPB 
RMVSEDIR TCPOCS.FTPB 
STATUS 
LDIR 
BYE 
/* 

/& 

* $$ EOJ 


Figure 190. VSE/ESA OC/FTP Client Batch Job for OS/2 2.1 Directory Operations 
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// JOB FTPCBAT DATE 07/10/96, CLOCK 14/34/52 

// OPTION NOLOG,NOSYSDUyP,JCANCEL 

OpenConnect Systems, VSE FTP Client V2.R2.M4.T1 (206) Task=21 
Cpu id 70001 is registered as primary. 

Cpu id 70001 is on trial until 12/30/96. 
ftp> ACF verification for CunknwnC passed 

ftp> Initializing LIBR local directory, press Center^ to continue 
ftp> LIBR path now: TCPOCS.USER VSE.TCPOCS.LIBRARY 

ftp> OPEN TCPCLl 

Attempting to establish a connection with domain name server : 

TCPCLl.ITSC.IHXI.COM (192.61.100.83 ) 

Host name resolved through domain name server: 

TCPCLl.ITSC.IHMI.COM (192.61.100.83 ) 

TCP Trying 192.61.100.83 

Vtam connection established to Lu/Port IPFT2S9B 
Connected to TCPCLl. ITSC. IBM.CCM 

220 tcpcll IBM TCP/IP for OS/2 - FTP Server ver 12:58:07 on Mar 16 1994 

Name: 

ftp> pram 

Password: 

331 Password required for pram. 

230 User pram logged in. 

ftp> ID=pram IP=192.61.100.83 LU=IPFT2S9B 
ftp> VSECD 

You now have no host LIBR working directory 

ftp> DEFAULTS MODE LIBR LIB TCPOCS 
Defaults command completed successfully 

ftp> VSECD .USRl 

ftp> LIBR path now: TCPOCS.USRl VSE.TCPOCS.LIBRARY 

ftp> PWD 

257 tC:\t is current directory. 

ftp> MKDIR C:\TCPIP\FTPC 
257 MKD command successful. 

ftp> RMDIR C:\TCPIP\FTPC 
250 RMD command successful. 

ftp> MKVSEDIR TCPOCS.FTPB 
CTCPOCS.FTPBC definition successful 


Figure 191 (Part 1 of 2). Output from OC/FTP Client Batch Job for OS/2 2.1 Directory 
Operations 
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ftp> RMVSEDIR TCPOCS.FTPB 
CTCPOCS.FTPBC removal successful 

ftp> STATUS 

Connected to TCPCLl. ITSC. IBM.CCM 

Vse execution - Partition (BG) - Task (21) 

Type: ASCII ; Structure: FILE ; Verbose: ON 
Prompting: ON ; Debugging: OFF; Tracing: OFF 
Current VSE working directory: TCPOCS. USRl 

Current Domain namne server default name suffix: ITSC.IBM.CCM 


ftp> LDIR 


TESTOOl 

B 

96-07-21 

11:23.46 


0001133 

TEST 

L 

96-07-07 

09:38.03 

96-07-11 13:55.30 

0000012 

TESTl 

L 

96-07-07 

09:45.24 

96-07-11 13:55.50 

0001133 

TEST 

LB 

96-07-21 

11:23.50 


0000100 

TEST 

LL 

96-07-21 

11:23.29 


0000100 

TEST 

PC 

96-07-11 

13:55.56 


0000012 

CONFIG 

TCP 

96-07-04 

14:35.55 


0000094 

PPPPP 

TCP IP 

96-07-11 

13:54.27 

96-07-12 08:26.59 

0001133 

PPPPPP 

TCP IP 

96-07-12 

08:27.37 


0001133 

PPPPP22 

TCP IP 

96-07-12 

08:28.35 


0001133 

P2 

TCP IP 

96-07-12 

08:26.03 

96-07-10 12:56.33 

0001133 

CONF928 TEXT 96-07-28 10:59.35 

directory request successful 


0000068 

ftp> BYE 

ftp> ID=pram 

221 Goodbye. 

IP=192.61, 

.100.83 

LU=IPFT2S9B 



Figure 191 (Part 2 of 2). Output from OC/FTP Client Batch Job for OS/2 2.1 Directory 
Operations 
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19.3 Online Operation Samples 

Before FTP commands can be entered interactively via the 'ftp' transaction, the 
OC/FTP Client must have been started in a dynamic partition. The startup job 
shown in Figure 67 on page 104 can be used to do this, Figure 192 shows the 
console log after startup. 


Y2 0047 // JOB FTPC 

DATE 07/11/96, CLOCK 11/11/23 
Y2 0047 * FTPC EXECUTION IN ONLINE MODE 
Y2 0047 OCSOOO INITIALIZATION IN PROGRESS 
Y2 0047 OCSOOO INITIALIZATION IS COMPLETE 
Y2 0047 OCS003 PHASE FTPC ATTACHED AS SUBTASK FTPCOOOl 
Y2 0090 ftp> ONLINE initialization started 
Y2 0090 ftp> ACF verification for STEF passed 
Y2 0090 ftp> ID=prain IP=192.61.100.81 LU=IPFT2S9B 
Y2 0047 OCSOlO DETACH COMPLETE FOR SUBTASK FTPCOOOl 


Figure 192. OC/FTP Client Startup Sample 

The cemmands shown In Table 13 can be passed to OC/FTP Client from the VSE 
console, using the 'msg' operator command: 

msg fx,data=c/T;cf 

where fx Is the partition name and cmd Is one of the commands shown in 
Table 13. 


Command 

Explanation 

status 

displays information about OC/FTP Client such as user names, 
subtask 

quiesce 

before shutting down the OC/FTP Client the operator lets current 
users complete their file transfer operation and disables further 
logins. 

stop 

shuts down immediately the OC/FTP Client, thereby forcing off all 
current users. 


Table 13. OC/FTP Client Job Commands 


The following two examples show multiple file transfer operations to/from an AIX 
node. 


19.3.1 Obtaining Multiple Files from AIX 

The examples shown in Figure 193 on page 264 and Figure 194 on page 265 
demonstrate the usage of the DEFAULT and MGET commands affecting the 
Librarian subsystem. 
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Note 


When this example was created, our OC/FTP Server used port number 2071 
and the AIX FTP Server used TCP/IP standard FTP port 21. Therefore, when 
no port number is specified in the FTP Open subcommand, the AIX FTP 
server is addressed. Also, the resolver file was not created in AIX to use the 
Domain Name system. 
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ftp> ACF verification for PRAM passed 
OpenConnect Systems, VSE FTP Client V2.R2.M4.T1(206) 


Task=5A 


Cpu id 70001 is registered as primary. 
Cpu id 70001 is on trial until 12/30/96. 


ftp> Initializing LIBR local directory, press <:enter<: to continue 

ftp> LIBR path now: TCPOCS.USER VSE.TCPOCS.Library 

ftp> 

ftp> default list 


Vsamcat 

=> 

TCPCAT 

Palloc 

=> 

00000256 Restart 

Salloc 

=> 

00000256 

Lrecl 

=> 

00000080 logging 

Recfm 

=> 

RECORD 

Cisizedata 

=> 

00002048 

Bufsp 

=> 

00000000 

Bufndata 

=> 

00000010 

Cpndsp 

=> 

NEW 

Clsdsp 

=> 

KEEP 

Retain 

=> 

00000007 

Mode 

=> 

LIBR 

Lib 

=> 

TCPOCS 

Slib 

=> 

USRl 

Mbrn 

=> 

FTPOBJ 

Mbrt 

=> 

TCP IP 

Bufnindex 

=> 

00000004 

Blkfactor 

=> 

00000001 

Keylocation 

=> 

00000000 

Keylength 

=> 

00000010 

Share 

=> 

00000002 

Units 

=> 

REC 

Cafreespace 

=> 

00000000 

Cifreespace 

=> 

00000000 

Cisizeindex 

=> 

00000000 

Skipcount 

=> 

00000000 

Recordcount 

=> 

00000000 

HALT 

=> 

OFF 

Dsn 

=> 

OCS.FTP.TESTING 



Modelentry 

=> 

NULL 




Lowkey 

=> 





Highkey 

=> 






=> OFF 
=> OFF 


ftp> 

ftp> default slib usr6 mbrt z dsn ftp 

Defaults command completed successfully 
ftp> 

ftp> default list 


Vsamcat 

=> 

TCPCAT 

Palloc 

=> 

00000256 Restart 

Salloc 

=> 

00000256 

Lrecl 

=> 

00000080 logging 

Recfm 

=> 

RECORD 

Cisizedata 

=> 

00002048 

Bufsp 

=> 

00000000 

Bufndata 

=> 

00000010 

Cpndsp 

=> 

NEW 

Clsdsp 

=> 

KEEP 

Retain 

=> 

00000007 

Mode 

=> 

LIBR 

Lib 

=> 

TCPOCS 

Slib 

=> 

USR6 

Mbrn 

=> 

FTPOBJ 

Mbrt 

=> 

Z 

Bufnindex 

=> 

00000004 

Blkfactor 

=> 

00000001 

Keylocation 

=> 

00000000 

Keylength 

=> 

00000010 

Share 

=> 

00000002 

Units 

=> 

REC 

Cafreespace 

=> 

00000000 

Cifreespace 

=> 

00000000 

Cisizeindex 

=> 

00000000 

Skipcount 

=> 

00000000 

Recordcount 

=> 

00000000 

HALT 

=> 

OFF 

Dsn 

=> 

FTP 




Modelentry 

=> 

NULL 




Lowkey 

=> 





Highkey 

=> 






=> OFF 
=> OFF 


Figure 193. DEFAULT Command Sample 
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ftp> open aix320 


TCP Trying 192.61.100.81 

Vtam connection established to Lu/Port IPFT2S9B 
Connected to AIX320 

220 aix320 FTP server (Version 4.9 Thu Sep 02 20:35:07 CDT 1993) ready. 

Name: 

ftp> pram 

Enter FTP Password> 
ftp> pram 


331 Password required for pram. 

230 User pram logged in. 

ftp> pwd 

257 t/home/pramt is current directory. 
ftp> pvsedir 

ftp> LIBR path is: TCPOCS.USRl VSE.TCPOCS.LIBRARY 

ftp> Is 

200 PORT command successful. 

150 Opening data connection for /bin/ls. 

OCS.TEST.KSDS 

OCS.TEST2.KSDS 

aixdata 

info 

mbox 

ocs.test.ksds 

ocs.test.vsamsam 

ocststl 

ocstst2 

prereq 

smit.log 

smit.script 

test 

test2 

test3 

226 Transfer complete. 

154 BYTES received in 0 SECONDS (0.00 KBYTES/S) 
ftp> mget ocs*.* 


Mget: ocs.test.ksds invalid name, new name OCSTESTK.Z 

retrieve(y/n/r/q)? 

ftp> y 

200 PORT command successful. 

150 Opening data connection for ocs.test.ksds (2025 bytes). 
226 Transfer complete. 

2050 BYTES received in 0 SECONDS (0.00 KBYTES/S) 

Mget: ocs .test .vsamsam invalid name, new name OCSTESTV.Z 

retrieve(y/n/r/q)? 


ftp> y 


Figure 194 (Part 1 of 2). MGET Command Sample 
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200 PORT coinmand successful. 

150 Opening data connection for ocs.test.vsamsam (68 bytes) . 
226 Transfer conplete. 

72 BYTES received in 0 SECONDS (0.00 KBYTES/S) 
ftp> mget a* 

Mget: aixdata invalid name, new name AIXDATA.Z 

retrieve(y/n/r/q)? 


ftp> r 

Mget: aixdata invalid name, new name 

ftp> aix.data 

200 PORT command successful. 

150 Opening data connection for aixdata (2025 bytes). 

226 Transfer complete. 

2050 BYTES received in 0 SECONDS (0.00 KBYTES/S) 
ftp> mget t* 

Mget: test invalid name, new name TEST.Z 

retrieve(y/n/r/q)? 


ftp> n 

Mget: test.a retrieve(y/n/q)? 

ftp> y 

200 PORT command successful. 

150 Opening data connection for test.a (24 bytes) . 

226 Transfer complete. 

27 BYTES received in 0 SECONDS (0.00 KBYTES/S) 

Mget: test2 invalid name, new name TEST2.Z 

retrieve(y/n/r/q)? 


ftp> q 


Figure 194 (Part 2 of 2). MGET Command Sample 


19.3.2 Transferring Multiple Files to AIX 

This example shows the usage of the DEFAULT and MPUT commands affecting 
the VSAM subsystem. 

First we set our default mode to 'VSAM' and the default data set name (dsn) to 
be The MPUT command uses dsn for searching files. For example, if dsn is 
"ABC", it searches for filenames starting with "ABC". In our case, all files are 
transferred using the 'MPUT *' command. 

In contrast to the FTP client batch operation where all FTP transfer messages 
appear in the corresponding job output list, the messages now are displayed cn 
the VSE console. On the FTP ccnsole log shown below (Figure 197 on page 268) 
you can verify, Icoking at BC (Byte Count) and RC (Record Count), that all data 
has been transferred. 
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Figure 195 on page 267 shows the DEFAULT command we used, Figure 196 on 
page 267 the MPUT command and Figure 197 on page 268 the VSE console log. 


ftp> default mode vsam dsn * 
ftp> default list 


Vsamcat 

=> 

TCPCAT 

Palloc 

=> 

00000256 Restart 

Salloc 

=> 

00000256 

Lrecl 

=> 

00000080 logging 

Recfm 

=> 

RECORD 

Cisizedata 

=> 

00002048 

Bufsp 

=> 

00000000 

Bufndata 

=> 

00000010 

Cpndsp 

=> 

NEW 

Clsdsp 

=> 

KEEP 

Retain 

=> 

00000007 

Mode 

=> 

VSAM 

Lib 

=> 

TCPOCS 

Slib 

=> 

USRl 

Mbrn 

=> 

ETPOBJ 

Mbrt 

=> 

TCP IP 

Bufnindex 

=> 

00000004 

Blkfactor 

=> 

00000001 

Keylocation 

=> 

00000000 

Keylength 

=> 

00000010 

Share 

=> 

00000002 

Units 

=> 

REC 

Cafreespace 

=> 

00000000 

Cifreespace 

=> 

00000000 

Cisizeindex 

=> 

00000000 

Skipcount 

=> 

00000000 

Recordcount 

=> 

00000000 

HALT 

=> 

OEF 

Dsn 

=> 





Modelentry 

=> 

NULL 




Lowkey 

=> 





Highkey 

=> 






=> OFF 
=> OFF 


Figure 195. DEFAULT Command Sample 


ftp> mput * 


Mput: ONEMB.DAT send(y/n/q)? 

ftp> Y 

200 PORT command successful. 

150 Opening data connection for onemb.dat. 

226 Transfer complete. 

1040457 BYTES sent in 1926 SECONDS (0.52 KBYTES/S) 

iy|)ut: TCPCAT.TEST.PC send(y/n/q)? 

ftp> Y 

200 PORT command successful. 

150 Opening data connection for tcpcat.test.pc. 

226 Transfer complete. 

1991 BYTES sent in 0 SECONDS (0.00 KBYTES/S) 

iy|)Ut : TEST. ETP. CLIENT send (y/n/q) ? 


Figure 196. MPUT Command Sample 
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Y2 0088 ftp> ID=prain 
Y2 0088 ftp> ID=prain 
Y2 0088 ftp> ID=prain 
Y2 0088 ftp> ID=prain 
Y2 0088 ftp> ID=prain 
Y2 0088 ftp> ID=prain 
Y2 0088 ftp> ID=prain 
Y2 0088 ftp> ID=prain 


IP=192.61.100.81 LU=IPFT2S9B 
DNONEMB.DAT 

MN=DAT RQ=PUT OD=OLD CD=KEEP 

BC=1,040,457 RC 16,149 

IP=192.61.100.81 LU=IPFT2S9B 
DN=TCPCAT. TEST. PC 

MN=PC RQ=PUT OD=OLD CD=KEEP 

BC 1,991 RC =67 


Figure 197. Console Log of MPUT Command 


19.3.3 Moving an AIX Data File into a VSAM KSDS 

This example demonstrates how to move an AIX data file to a VSAM KSDS using 
the OC/FTP Client 'get' command. 

First we set the default mode to 'VSAMKSD' and deleted our original file 
"OCS.TEST.KSDS". Then we transferred the file from AIX using FTP 'get'. The 
result is a new file "OCS.TEST.KSDS" with a keylength of 10 since the implicit 
define used the keylength of the default parameter. For transferring data to/from 
VSAM KSDSs, the keylength and keyposition have to be considered and 
specified. 

Next we demonstrate the use of the RDK (Remove Duplicate Keys) option. In 
order for this parameter to work, you also need to set the Opndsp (Open 
Disposition) of the file to 'OLD'. 

Figure 198 on page 269 shows the online example to transfer an AIX data file 
into a VSAM KSDS and Figure 199 on page 270 shows the VSE II (Interactive 
Interface) screen containing the VSAM data set information we reoeived. 

- Note - 

When this example was created, our OC/FTP Server used port number 2071 
and the AIX FTP Server used TCP/IP standard FTP port 21. Therefore, when 
no port number is specified in the FTP Open subcommand, the AIX FTP 
server is addressed. Also, the resolver file was not oreated in AIX to use the 
Domain Name system. 
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OpenConnect Systems, VSE FTP Client V2.R2.M4.T1 (206) Task=5A 
Cpu id 70001 is registered as primary. 

Cpu id 70001 is on trial until 12/30/96. 

ftp> LIBR path now: TCPOCS.USER VSE.TCPOCS.Library 

ftp> 

ftp> default list 


Vsamcat 

=> 

TCPCAT 

Palloc 

=> 

00000256 Restart 

Salloc 

=> 

00000256 

Lrecl 

=> 

00000132 logging 

Recfm 

=> 

RECORD 

Cisizedata 

=> 

00002048 

Bufsp 

=> 

00000000 

Bufndata 

=> 

00000010 

Cpndsp 

=> 

NEW 

Clsdsp 

=> 

KEEP 

Retain 

=> 

00000007 

Mode 

=> 

LIBR 

Lib 

=> 

TCPOCS 

Slib 

=> 

USRl 

Mbrn 

=> 

FTPOBJ 

Mbrt 

=> 

TCP IP 

Bufnindex 

=> 

00000004 

Blkfactor 

=> 

00000001 

Keylocation 

=> 

00000000 

Keylength 

=> 

00000010 

Share 

=> 

00000002 

Units 

=> 

REC 

Cafreespace 

=> 

00000000 

Cifreespace 

=> 

00000000 

Cisizeindex 

=> 

00000000 

Skipcount 

=> 

00000000 

Recordcount 

=> 

00000000 

HALT 

=> 

OFF 

Dsn 

=> 

ocs. FTP.TESTING 



Modelentry 

=> 

NULL 




Lowkey 

=> 





Highkey 

=> 






=> OFF 
=> OFF 


ftp> default mode vsamksd 

Defaults command completed successfully 

ftp> vsecd tcpcat 

ftp> VSAMKSD path now: TCPCAT TCP IP. USER. CATALOG 

ftp> open aix320 

TCP Trying 192.61.100.81 

Vtam connection established to Lu/Port IPFT2S9B 
Connected to AIX320 

220 aix320 FTP server (Version 4.9 Thu Sep 2 20:35:07 CDT 1993) ready. 

Name: 

ftp> pram 

Enter FTP Password> 
ftp> pram 

331 Password required for pram. 

230 User pram logged in. 

ftp> ocs.test.ksds 

/CCS.TEST.KSDSC removal successful 


ftp> get ocs.test.ksds 
200 PORT command successful. 

150 Opening data connection for ocs.test.ksds (2025 bytes). 
226 Transfer conplete. 

2050 BYTES received in 1 SECONDS (2.00 KBYTES/S) 

ftp> default opndsp old rdk on 

ftp> get ocs.test.ksds 
200 PORT command successful. 

150 Opening data connection for ocs.test.ksds (2025 bytes). 
226 Transfer conplete. 

2050 BYTES received in 1 SECONDS (2.00 KBYTES/S) 


Figure 198. Transferring a Fiie from AIX into a VSAM KSDS 
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lESFILDETA 


SHOW FILE INFORMATION 


File Attributes: 

Attribute Values: 


FILE ID: 

OCS.TEST 

KSDS 


FILE NAME: 

*NONE* 



CATALOG NAME: 

TCPCAT 



FILE ORGANIZATION: 

2 


l=Non keyed (ESDS) 

3=Nuinbered (RRDS) 




2=Keyed (KSDS) 

4=Nuinbered (VRDS) 

5=Sequential (SAM ESDS) 

FILE ACCESS: 

2 


l=Multiple Read OR Single Write 

2=Multiple Read AND Single Write 

3=Multiple Read AND Write (no integrity) 
4=Multiple Read AND Write (with integrity) 

FILE USAGE: 

2 


l=File is used as a 

Data File (NOREUSE) 




2=File is used as a 

Work File (REUSE) 

CREATION DATE: 


94316 



EXPTRATION DATE: 


00000 



ALLOCATION UNIT: 


2 

l=Cylinder, 2=Track, 3=Block 

PRTMARY ALLOCATION: 


1 



SECONDARY ALLOCATION: 


1 



AVERAGE RECORD SIZE: 


132 



MAXIMUM RECORD SIZE: 


132 



KEY LENGTH: 


10 



KEY POSITION: 


0 

Position 0 starts 

at the beginning 



Data Conponent: 

Index Corrponent: 

NUMBER OF Cl SPLITS: 


0 


0 

NUMBER OF CA SPLTTS: 


0 


0 

NUMBER OF PHYSICAL I/Os 


4 


4 

CURRENTLY ALLOCATED SPACE: 

36864 

Bytes 

23552 Bytes 

CURRENTLY USED SPACE: 


36864 

Bytes 

512 Bytes 

AVATLABLE SPACE: 


0 % 

free 

97 % free 

Cl SIZE: 


2048 

Bytes 

512 Bytes 

NUMBER OF CIS PER CA: 


18 


46 


Figure 199. Display VS AM KSDS after FTP File Transfer 
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19.3.4 Transferring an AIX Data File into a VSAM SAM File 

Before we transferred the file we set the default mode to 'VSAMSAM', the record 
format to 'FIXBLK' and deleted the original file "OCS.TEST.VSAMSAM". Then we 
transferred the file from AIX using FTP 'get'. 

Figure 200 shows the online example of subject file transfer and Figure 201 cn 
page 272 lists the information from the corresponding VSE II. 

- Note - 

When this example was created, our OC/FTP Server used port number 2071 
and the AIX FTP Server used TCP/IP standard FTP port 21. Therefore, when 
no port number Is specified In the FTP Open subcommand, the AIX FTP 
server Is addressed. Also, the resolver file was not created In AIX to use the 
Domain Name system. 


ftp> default mode vsamsam recfm fixblk 

Defaults coinmand completed successfully 
ftp> Idel ocs.test. vsamsam 

COCS.TEST.VSAMSflMC removal successful 
ftp> get ocs.test.vsamsam 

200 PORT command successful. 

150 Opening data connection for ocs.test.vsamsam (68 bytes) . 
226 Transfer conplete. 

72 BYTES received in 0 SECONDS (0.00 KBYTES/S) 
ftp> status 

Connected to AIX320 


Vse execution - Partition(Zl) - Task(55) 

Type: ASCII ; Structure: FILE ; Verbose: ON 
Prompting: ON ; Debugging: OFF; Tracing: OFF 
Current VSE working directory: TCPCAT 
Current Domain name server default name suffix: 

ftp> bye 


221 Goodbye. 


Figure 200. Transferring a File from AIX Into a VSAM SAM 
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lESFILDETA 

SHOW FILE INFORMATION 

File Attributes: 

Attribute Values: 

FILE ID: 

OCS.TEST 

VSAMSAM 

FILE NAME: 

OCSSAM 


CATALOG NAME: 

TCPCAT 


FILE ORGANIZATION: 

5 

l=Non keyed (ESDS) 3=Nuinbered (RRDS) 
2=Keyed (KSDS) 4=Nuinbered (VRDS) 

5=Sequential (SAM ESDS) 

FILE ACCESS: 

2 

l=Multiple Read OR Single Write 

2=Multiple Read AND Single Write 

3=Multiple Read AND Write (no integrity) 
4=Multiple Read AND Write (with integrity) 

FILE USAGE: 

2 

l=File is used as a Data File (NOREUSE) 

2=File is used as a Work File (REUSE) 

CREATION DATE: 

94307 


EXPTRATION DATE: 

00000 


ALLOCATION UNIT: 

2 

l=Cylinder, 2=Track, 3=Block 

PRTMARY ALLOCATION: 

2 


SECONDARY ALLOCATION: 

1 

l=Fixed unblocked, 2=Fixed blocked, 

RECORD FORMAT: 

2 

3=Variable unblocked, 4=Variable blocked, 
5=Undefined, 6=No control interval format 

RECORD SIZE: 

132 


BLOCK SIZE: 

132 


NUMBER OF Cl SPLITS: 

0 


NUMBER OF CA SPLTTS: 

0 


NUMBER OF PHYSICAL I/Os 

0 


CURRENTLY ALLOCATED SPACE: 73728 

Bytes 

CURRENTLY USED SPACE: 

2048 

Bytes 

AVATLABLE SPACE: 

97 % 

free 

Cl SIZE: 

2048 

Bytes 

NUMBER OF CIS PER CA: 

18 



Figure 201. Display VSAM SAM after FTP Fiie Transfer 
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Chapter 20. OC/Line Printer Daemon Operation and Exampies 

This chapter: 

• provides instructions on how to start and operate the OC/Line Printer 
Daemen at the VSE host side. 

• expiains how to check the status of OC/Line Printer Daemon print queues 
from TCP/iP nodes. 

• expiains how to print fiies from TCP/iP nodes on the VSE host. 

• gives exampies of Line Printer operations that we tested in our environment. 


20.1 Operation 

This sectien describes how the OC/Line Printer Daemon is started and provides 
an overview of the commands avaiiabie at both, the ciient and server side. 


20.1.1 VSE Host (Line Printer Server) 

To start OC/Line Printer Daemon, the jeb described in Figure 75 on page 117 is 
used. Figure 202 beiew shows a sampie consoie iog after having started the 
OC/Line Printer Daemon. 


Y3 0048 // JOB LPD START LINE PRINTER DAEMON 
DATE 07/17/96, CLOCK 16/20/19 

Y3 0048 OpenConnect Systems, LPD Server VI.R1.MO.TO(8) Ready for client. 

Figure 202. OC/Line Printer Daemon Startup Sample 

To Stop the OC/Line Printer Daemon, cancel the partition in which it is running 
using the following command at the VSE censole: 

cancel fx,nodump 

where fx is the partitien name that is running OC/Line Printer Daemon. 

Figure 203 below shows a sample console log after cancelling the partition. 


cancel y3,noduirp 
AR 0015 1I40I READY 

Y3 0048 OSOIT THE OPERATOR CANCELED THE JOB 
Y3 0048 OSOOI JOB LPD CANCELED 

Y3 0048 0S07I PROBLEM PROGRAM PSW = 07DD0000 00434A9C 
F3 0003 IST804T CLOSE IN PROGRESS FOR OCSSMPOl OPENED BY LPD 
F3 0003 IST400I TERMINATION IN PROGRESS FOR APPLID OCSSMPOl 
F3 0003 IST805I VTAM CLOSE COMPLETE FOR OCSSMPOl 


Figure 203. Stopping OC/Line Printer Daemon by Canceiling the Partition 
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— Note - 

There is no other possibility to stop OC/Line Printer Daemon operation 
except by cancelling the partition in which it is running. 


20.1.2 Displaying the Status of OC/Line Printer Daemon Queues 

To check the status of the OC/Line Printer Daemon Queues, use the 'Ipstat' 
command on the OCS II Gateway. 

Figure 204 shows a sample response to the Ipstat command 


root@aix320: /etc >lpstat 
Queue Dev Status Job Files 


IpO IpO DOWN 

bsh bshde READY 

vseprtm vsepr READY 

vseprtm: Queue(VSEPRTM ) Type(Power 

Ipdfile Ipdfi READY 

Ipdfile: Queue(LPDFILE ) Type(DSN 

sysout sysou READY 

sysout: Queue(SYSQUT ) Type(Power 

vseprt vsepr READY 

vseprt: Queue(VSEPRT ) Type(Power 

root@aix320: /etc > 


User PR % Blks Cp Rnk 


) Ready. H=Y, M=Y, C=A, F=STD 
) Ready. H=Y, M=Y, C=A, F=STD 
) Ready. H=N, M=Y, C=A, F=STD 
) Ready. H=Y, M=N, C=A, F=STD 


Figure 204. Ipstat Sample Output 

Ipstat returns the status of all printer queues defined to AIX. The sample output 
contains the local queues IpO and bsh and the OC/Line Printer Daemon queues 
vseprtm, Ipdfile, sysout, and vseprt as described in 8.2.2.1, “LPDCONF Member” 
on page 112. 

For these remote queues the Ipstat output shows two entries: 

• vseprtm shows the status of the local AIX queue. 

- Note - 

If the status of this local queue is DOWN, the status of the remote queue 
will not be displayed and no print requests will be forwarded to OC/Line 
Printer Daemon. 

To correct this, the local queue must be started. This can be done by 
using the following SMIT command sequence: 

• Spooler (Print Jobs) 

• Manage Local Printer Subsystem 

• Local Printer Queues 

• Start a Queue 


• vseprtm: shows the status of the OC/Line Printer Daemon queue on 
VSE/ESA. Below is a short description of the status values: 

- Type(DSN) Output will be spooled to data set. Relates to DDNAME = 
parameter of LPDCONF.LPDPARM 
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Type(Power) Output will be spooled to POWER LST queue. Relates to 
SYSOUT= parameter of LPDCONF.LPDPARM 


- H= specifies if output wiil be proceeded with Print Banner. Reiates to 
H= parameter of LPDCONF.LPDPARM 

- M = specifies if the Line Printer requester wili be notified by E-mail. 
Relates to MAIL= parameter of LPDCONF.LPDPARM 

- C= specifies the Power LST queue ciass the print output wiii be spooied 
in (meaningiess in combination with Type(DSN)). Reiates to SYSOUT= 
parameter of LPDCONF.LPDPARM 

- F= specifies the Power Form used for print output to this OC/Line 
Printer Daemon queue (meaningiess in combination with Type(DSN)). 
Relates to F = parameter of LPDCONF.LPDPARM 

To query the status of a particular queue, you may use the -v parameter of the 
Ipstat command. 

Another command to check the status of a particular queue is the standard iine 
printer command Ipq. For details about the parameters of this command refer to 
the appropriate documentation of your Line Printing Ciient. Figure 205 shows a 
sampie response to the OS/2 LPO command : 


[C:\]lpq -1 -s aix320 -p vseprtm 

Queue (VSEPRTM ) Type (Power ) Ready. H=Y, M=Y, C=A, F=STD 


Figure 205. LPQ Sample Output 


20.1.3 Printing from Remote TCP/IP Ciients 

To print a fiie from remote TCP/IP clients, use the ipr command. For details 
about the parameters for this command refer to the appropriate documentation 
of your Line Printing Ciient. Figure 206 shows a sample response to the OS/2 
Ipr command. 


[C:\]lpr config.sys ~s aix320 -p vseprt 
Printing C:\CONFIG.SYS: 

Trying LPD print server aix320 .itsc. ibm.com(192.61.100.81) , device vseprt. 
Sent 5501 bytes. 

The entire document was sent. 


Figure 206. LPR Sample Output 
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— Attention - 

Most LPR clients provide a -f parameter which indicates that the remote LPD 
should format the print output using the UNIX pr command. 

If this parameter is specified on requests to the OC/Line Printer Daemon, the 
partition running OC/Line Printer Daemon will enter a loop with heavy I/O. 

If this occurs, you have to cancel the partition and resubmit the OC/Line 
Printer Daemon startup job. 
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20.1.4 Operation Examples 


20.1.4.1 Printing a File from OS/2 to a POWER Queue 

The following file (containing the standard ASCII characters 32 to 126), is sent to 
the OC/Line Printer Daemon: 


ASCII CHAR SET 
0123456789ABCDEF 


!t#$%&C ()*+,-./ 20 
0123456789:;<=>? 30 

@ABCDEFGHIJKLMNO 40 
PQRSTUVWXYZ [ | ] ^_ 50 

abcdefghi jklnino 60 
pqrstuvwxyz{I}~ 70 


Figure 207. Test File with Standard ASCII Characters 32-126 (X'lQ-X'lE). 

This file is sent to OC/Line Printer Daemon using the following OS/2 command: 

Ipr TEST.DATA -s aix320 -p sysout 

- Note - 

We always got the following error message on the VSE/ESA console, when 
using the OS/2 Ipr command: 

Y1 0045 LPD:00 & Cortmand record ignored. 

This message can be ignored. 


After completion of the Ipr command the following POWER LST queue entry can 
be found: 


d lst,lpd* 

AR 0015 1C39I COMMAND PASSED TO VSE/POWER 

FI 0001 1R46I LIST QUEUE P D C S PAGES CC FORM 

FI 0001 1R46I LPD 04562 3 DA 11 STD TO= (DIRK) FROM=(DIRK) 


The name of this entry will always be the same as the VSE/POWER job name of 
the OC/Llne Printer Daemon startup job. This entry will display a screen similar 
to the following In VSE Interactive Interface: 
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ASCII CHAR SET 
0123456789ABCDEF 


!t#$%&C ()*+,-./ 20 
0123456789:;<=>? 30 
@ABCDEFGHIJKLMNO 40 
PQRSTUVWXYZA" _ 50 
abcdefghi jklnino 60 
pqrstuvwxyzi|} 70 


— Note - 

The following characters are not standard EBCDIC characters and may 
therefore not be displayed and printed correctly: 

• [ left bracket 

• ] right bracket 

• ~ tilde 

• caret 

• right prime 


Since SENDMAIL is not started on our OS/2 system, we will not get an E-mall 
notification for completion of our line printer request. 


20.1.4.2 Printing a File from AIX to a VSAM File 

The same file as shown In Figure 207 on page 277 Is sent to the OC/Llne Printer 
Daemon using the following AIX command: 

Ipr -Plpdfile test.data 

After completion of the Ipr command the VSAM SAM ESDS 'LPDFILE' will appear 
as the following: 
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0000000 CCCCCCC SSSSSS / LL PPPPPPPP DDDDDDDD 
00 00 00 SS SS / LL PP PP DD DD 

00 00 CO SS / LL PPPPPPPP DD DD 

00 00 CC SS SS / LL PP DD DD 

0000000 CCCCCCCC SSSSSSS / T,T,T,T,T,T, PP DDDDDDDD 

OpenConnect Systems, LPD/Server VI. Rl. MO. TO (8) 


GATEWAY 
HOST NAME 
DELIVER TO 
JOB NAME 
LOGON ID 
DATE QUEUED 
COPIES : 


VSE 

aix320 

root 

test.data 
root 

01:10:30, Fri Jul 19, 1996 
001 




ASCII CHAR SET 
0123456789ABCDEF 


0000000 CCCCCCC SSSSSS / 
00 00 00 SS SS / 

00 00 00 SS / 

00 00 CC SS SS / 

0000000 CCCCCCCC SSSSSSS / 


LL 

LL 

LL 

LL 

T.T.TIII, 


PPPPPPPP DDDDDDDD 
PP PP DD DD 
PPPPPPPP DD DD 
PP DD DD 

PP DDDDDDDD 


!t#$%&9 ()*+,-./ 20 
0123456789:;<=>? 30 
@ABCDEFGHIJKIMND 40 
PQRSTUVWXYZA" _ 50 
abcdefghijklmno 60 
pqrstuvwxyz{|} 70 


Figure 208. VSAM Print Output of LPDFILE 


Since the mailer daemon is started on AIX, we will get the following E-mall 
notification. 


From IpdOvse Thu Jul 18 08:49:50 1996 
Date: Thu, 18 Jul 1996 08:49:46 +0100 
From: lpd@vse 
Subject: Your print. 

Apparently-To: root@aix320 

Your print has been routed to the queue 
you selected. 

Thank you for using CpenConnect Systems products. 


Figure 209. E-mail Notification from OC/Line Printer Daemon 
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Chapter 21. OC/RSH Client Operation and Examples 

The OC/RSH Client is invoked in the VSE environment via a CICS transaction or 
a VSE batch job. 

Before executing commands on remote TCP/IP nodes with the OC/RSH Client 
you need to make sure that: 

• There is an active RSH server on the remote node 

• You are authorized for remote command execution on the remote node 

The OC/RSH Client program is designed to invoke programs on remote TCP/IP 
hosts which obtain their input from commands and write results to the standard 
output device for commands, that is, the terminal. This means that you cannot 
invoke interactive programs such as the vi editor under AIX. 

There are two ways to initiate remote command execution from the VSE host: 

1. Interactively using CICS transaction rsh' 

This requires that the OC/RSH Client program has been started and is 
running in a dynamic partition. CICS ISC is used to pass all interactive RSH 
commands to the OC/RSH Client program (see Figure 9 on page 25). 

2. Using a batch job 

This requires that all RSH commands have to be imbedded in the job. As 
shown in Figure 79 on page 126 the OC/RSH Client program then manages, 
together with VTAM, all communications to the OCS II Gateway. 
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21.1 OC/RSH Client Online Operation Examples 

Before RSH commands can be entered interactively via the 'rsh' transaction, 
OC/RSH Client must have been started in a dynamic partition. Since the RSH 
functions have been implemented in the OC/FTP Client program, we use its 
startup job shown in Figure 67 on page 104. Figure 210 shows the VSE console 
log after OC/FTP Client startup. 


Y2 0047 // JOB FTPC 

DATE 07/11/96, CLOCK 11/11/23 
Y2 0047 * START FTP AND RSH CLIENT 
Y2 0047 OCSOOO INITIALIZATION IN PROGRESS 
Y2 0047 OCSOOO INITIALIZATION IS COMPLETE 


Figure 210. OC/RSH Client Startup Sample 

The commands shown in Table 14 can be passed to the OC/RSH Client from the 
VSE console, using the 'msg' operator command: 

msg fx,data=cmcl 

where fx is the partition name and cmd is one of the commands shown in 
Table 13 on page 262. The commands are the same as for the OC/FTP Client 
program. 


Command 

Explanation 

status 

displays information about OC/RSH Client such as user names, 
subtask. 

quiesce 

before shutting down the OC/RSH Client the operator lets current 
users complete their command execution. 

stop 

shuts down immediately the OC/RSH Client, thereby forcing off all 
current users. 


Table 14. OC/RSH Client Job Commands 


Figure 211 on page 283 and Figure 212 on page 283 demonstrate the usage of 
the OC/RSH Client. 


282 TCP/IP for VSE/ESA 





RSH/Client for VSE. Version 2 Release 1.5.1 

Default Userid: WACKER enter alternate replacement, for change 

rsh> parmlib TCPOCS.FTPC 

Parmlib is now set to: TCPOCS.FTPC 

rsh> rsh aix320 -1 wacker -n echo $HOME; Is -1 


/u/wacker 
total 40 


-irwxr- 

1 wacker 

staff 

254 Sep 

30 

17:35 .profile 

~rw-r —r— 

1 wacker 

system 

482 Oct 

6 

17:29 birthday 

~rw-r —r— 

1 wacker 

system 

36 Sep 

30 

16:02 cde 

-rw-r —r— 

1 wacker 

system 

40 Oct 

6 

12:07 is.file 

-rw-r—r— 

1 root 

system 

1268 Oct 

7 

16:10 masterplan 

drwxr-xr-x 

2 wacker 

system 

512 Sep 

30 

15:30 puss.l 

~rw-r —r— 

1 wacker 

system 

19 Sep 

30 

15:08 wacktest 

-rw-r —r— 

1 wacker 

system 

280436 Oct 

6 

17:21 tcptrace 


Figure 211. List AIX Directory Using OC/RSH Client 

After having entered the 'rsh' transaction, the program displays the default user 
ID to be used for communication with the remote RSH server. Press enter to 
accept that user ID, then enter the RSH 'parmlib' command to display the default 
library where the OC/FTP Client administration files reside (refer to 7.2.4, “FTP 
Client Customization” on page 92). 

Then the remote command can be typed In and sent to the RSH server ('aix320' 
In our case) as shown in the example below. 


rsh> aix320 -1 wacker -n grep Nov birthday 

Nov 03 James McMiller 

Nov 12 Mary 

Nov 17 Steve 

Nov 25 Connie 

Nov 30 Iren 

rsh> aix320 -1 wacker -n rm maste 2 rplan 

No data was returned from the TCP/IP host for the command entered. 
rsh> bye 


Figure 212. File Manipulation Sample 
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21.2 Batch Operation Samples 

This section contains a batch job and its corresponding output iisting for remote 
sheii command execution. 


21.2.1 RSH Batch Example 

Figure 213 shows the job we used to do remote command execution and 
Figure 214 shows the output produced by the job. 


* $$ JOB JNM=RSHBATCH,DISP=D,PRI=3, C 

* $$ NTFY=YES, C 

* $$ LDEST=(,RSCS), C 

* $$ CLASS=Y 

* $$ LST CLASS=Z 

// JOB RSHBATCH 

// OPTION NOLOG, SYSDUMP, JCANCEL 
// LIBDEF *,SEARCH=TCPOCS.FTPC,TEMP 
// EXEC PGiyh=RSHC,SIZE=(RSHC,256K) 

PARMLIB TCPOCS.FTPC 

RSH AIX320 -1 wacker -n date; echo SHOME; Is -1 
RSH AIX320 -1 wacker -n cat /etc/hosts 
RSH AIX320 -1 maru -n Is -1 grep Oct 
RSH 192.61.100.81 -1 maru -n Is -1 grep Oct 
BYE 
/* 

/& 

* $$ EOJ 


Figure 213. RSH Batch Example 


// JOB RSHBATCH DATE 07/10/96, CLOCK 11/04/26 

// OPTION NOLOG, NOSYSDUMP,JCANCEL 

RSH/Client for VSE. Version 2 Release 1.5.1 

PARMLIB TCPOCS.FTPC 

Parmlib is now set to: TCPOCS.FTPC 

RSH AIX320 -1 wack -n date; echo $HOME; Is -1 
Wed Jul 10 12:00:03 CDT 1996 
/u/wack 
total 40 


rwxr 

1 wacker 

staff 

254 Sep 

30 17:35 .profile 

-rw-r—r— 

1 wacker 

system 

482 Oct 

6 17:29 birthday 

-rw-r—r— 

1 wacker 

system 

36 Sep 

30 16:02 cde 

-rw-r—r— 

1 wacker 

system 

40 Oct 

6 12:07 Is.file 

-rw-r—r— 

1 root 

system 

1268 Oct 

7 16:10 masterplan 

drwxr-xr-x 

2 wacker 

system 

512 Sep 

30 15:30 puss.l 

-rw-r—r— 

1 wacker 

system 

19 Sep 

30 15:08 wacktest 

-rw-r—r— 

1 wacker 

system 

280436 Oct 

6 17:21 tcptrace 


Figure 214 (Part 1 of 3). RSH Batch Example Output Listing 
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RSH AIX320 -1 wacker -n cat /etc/hosts 

# looback network (for testing on a local site) 

# 

127.0.0.1 localhost 

# 

# COMPONENT NAME: cnnd_tcpip 

# FUNCTIONS: none 

# Licensed Materials - Property of IBM 

# This Module is tRestricted Materials of IBMt 

# Product#5756-112 (C) Copyright IBM Corp. 1992 

# See Copyright Instruction (Panphlet G1202083) 

# 

9.164.182.11 megal tlrmegal # Added by BOS Install 

# 

# AIXESA hosts via ESCON 
25.0.0.1 emegal esal esconl 

25.0.0.2 emega2 esa2 escon2 # Added by BOS Install 

192.61.100.83 tcpcll #ps/2 client johnny 

192.61.100.84 tcpcl2 #ps/2 client francesco 
192.61.100.82 tcpgtw2 #ps/2 server ip/2 yuki 

192.61.100.14 9221ctr 

192.61.200.14 9221c 
192.61.200.60 nec 
192.61.200.91 sun2 

192.61.200.55 rs6tec 

192.61.100.55 rs6tectr 
192.61.100.54 rs6tdbtr 
192.61.100.81 aix320 
111.111.111.111 aix320 


Figure 214 (Part 2 of 3). RSH Batch Example Output Listing 


RSH AIX320 -1 maru -n Is -1 grep Oct 

-rw-r—r— 1 root system 0 Oct 6 12:21 news.data 

RSH 192.61.100.81 -1 maru -n Is -1 grep Oct 

-rw-r—r— 1 root system 0 Oct 6 12:21 news.data 

BYE 

LISTLOG UTILITY 

COUNT MESSAGE TEXT CLOCK DATE PAGE 1 

1 BG 000 // JOB RSHBATCH 11:04:26 07/10/96 

2 DATE 07/10/96,CLOCK 11/04/26 11:04:26 07/10/96 

END OF LISTLOG UTILITY 


Figure 214 (Part 3 of 3). RSH Batch Example Output Listing 
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Chapter 22. OC/TELNET FS Operation and Examples 


As explained in chapter 3.6, “OC/TELNET FS Functional Overview” on page 26 
and illustrated in Figure 10 on page 27, OC/TELNET FS runs in a dynamic 
partition as a VTAM application. This means that OC/TELNET FS must have 
been started before you can log on to a TCP/IP Telnet Server. Figure 215 shows 
the console log of the OC/TELNET FS startup job. 


Y1 0046 // JOB TNFS START OC/TELNET CLIENT EULL SCREEN 
DATE 07/05/96, CLOCK 14/11/05 

Y1 0046 TAIOOOI OC/TELNET ES VERSION 4.1.1 (12/19/94) IS STARTING 
Y1 0046 TAI007I *** NOTE - PROGRAM NOW EXECUTING ON CPU 70001 
Y1 0046 TAI008I *** NOTE - PROGRAM LOADED AT ADDRESS 00420078 
Y1 0046 TAI220I *** NOTE - MAJOR ACBNAME IS VSTELNET 
Y1 0046 TAI222I *** NOTE - MINOR ACBNAMES ARE VSNETNNN 
Y1 0046 TAIOOOI OC/TELNET ES VERSION 4.1.1 (12/19/94) IS ACTIVE 
Y1 0046 TAIOOOI USE MSG COMMAND TO COMMUNICATE WITH THIS PROGRAM 
Y1 0046 TAI300I D08001 LOGON IN PROGRESS 

Y1 0046 TAI302I D08001 LOGON ACCEPTED (VSNETOOl/00000000) - NUM 

USERS IS 1 

Y1 0090 TAIOOOI D08001 CONNECTED TO LU IPET2S9J HOST 192.61.10 

PORT 23 

Y1 0046 PARTITION WAITING EOR CONSOLE INPUT - REPLY STOP TO TERMINATE 

Yl-0046 
46 STOP 

Y1 0046 TAIOOOI STOP COMMAND ACCEPTED 
Y1 0046 EOJ TNES 


Figure 215. OC/TELNET FS Startup Job Sample 

The commands shown in chapters 26 and 27 of OpenConnect/TELNET Client Full 
Screen User and Administration Guide, 350-0145-101 can be passed to 
OC/TELNET FS from the VSE console using the 'msg' operator command: 

msg fx 

where fx is the partition name. After you receive a response from the partition, 
type the command as shown in the sample Figure 215 above. 


22.1 Operation Samples 

To use the TELNET functions in order to log on to a remote TCP/IP node, you 
need first to log on to the appropriate VTAM application (VSTELNET) which 
connects your terminal to the OCS II Gateway (refer to section 3.6, “OC/TELNET 
FS Functional Overview” on page 26 and chapter Chapter 10, “OC/TELNET FS 
Installation and Customization” on page 133 for details): 

logon applid(vstelnet) 
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22.2 Working with Teinet Paneis 

After connection with OC/TELNET FS has been established, the TELNET Primary 
Option Menu shown in Figure 216 is presented. 

The Primary Option Menu lets you define your terminal environment and 
overwrite the default values specified In the DFLTUSR file (refer section 10.2.2, 
“TELNET Client Customization” on page 137). 

Figure 216 to Figure 219 on page 292 show the options available for terminal, 
translation table and keyboard definition. 


OPTION => 

1 SETUP 

2 TRANSLATE 

3 KEYBOARD 
0 OPEN 

C CLOSE 
T TERMINAL 
Q QUIT 


TELNET PRIMARY OPTION MENU 


TERMINAL - D0810016 

- Specify terminal setup options APPL ID - VSNETOOl 

- Specify translation table infonnation 

- Specify keyboard definitions 

- Connect to another host within a TCP/IP Network 

- Ternninate the current connection 

- Begin terminal mode 

- Terminate TELNET session 


Enter QUIT command to terminate your session with TELNET. 


OC/Telnet FS Version 4.1.1 (12/19/94) 

Copyright (c) 1984-1994 by Teubner & Associates, Inc., All Rights Reserved 
Distributed by OpenConnect Systems, Inc. 


PE 1= 2= 3=QUIT 4= 5= 6= 

PF 7= 8= 9= 10= 11= 12=QUIT 


Figure 216. TELNET Primary Menu 

• 1 SETUP. The terminal setup menu (Figure 217 on page 289) Is displayed 

• 2 TRANSLATE. The translation table setup menu (Figure 218 on page 291) Is 
displayed 

• 3 KEYBOARD. The keyboard setup menu (Figure 219 on page 292) is 
displayed 

• O OPEN. The host selection panel (Figure 220 on page 293) Is displayed 

• C CLOSE. The current session with your Telnet partner Is closed 

• T TERMINAL. After a TN connection is established, you can enter remote 
host commands as if your terminal were attached to that host. The remote 
host welcome menu Is displayed as a result of the TN connection. An 
example of connecting to an AIX node Is shown In Figure 220 on page 293 

• Q QUIT. The session with OC/TELNET FS Is closed 
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TERMINAL SETUP OPTIONS PANEL 


ENTER/VERIFY OPTIONS BELOW: 


TERMINAL TYPE 

=> VTIOO 

(LINE, PAGE, VTIOO, VT200) 

KEYBOARD PROFILE 

=> VTIOO 

(DEFAULT IS TERMINAL TYPE) 

DISPLAY MODE 

=> BLOCK 

(BLOCK, PAGE, LINE, CONT) 

LOCAL ECHO 

==> NO 

(YES, NO) 

NEW LINE 

==> YES 

(YES, NO) 

AUTO WRAP 

=> NO 

(YES, NO) 

SHIFT LOCK 

==> NO 

(YES, NO) 

COMMAND PREFIX 

==> 

(SINGLE CHAR. OR FIELD f 

AUTO KEYBOARD UNLOCK 

==> DATA 

(YES, NO, DATA) 

VERTICAL CURSOR MOVEMENT 

=> DATA 

(NEW, LEFT, DATA) 

HORIZONTAL CURSOR MOVEMENT 

==> DATA 

(NEW, DATA) 

CURSOR MOVEMENT SEQUENCE 

==> SINGLE 

(SINGLE,EDT,VI) 


SPECIFY HORIZONTAL TAB STOPS BELOW: 

12345678 

2345678901234567890123456789012345678901234567890123456789012345678901234567890 


PF 1= 
PF 7= 


3=END 

9= 


4= 

10 = 


5= 

11 = 


6 = 

12=END 


Figure 217. Terminal Setup Sample 

• TERMINAL TYPE. You can choose the desired terminal emulation. The 
allowed values are shown on the right side of the screen 

• KEYBOARD PROFILE. You can choose the desired keyboard mapping. The 
value selected must match one of the names in the VSAM 
TEST.PARMLIB. type data set, where type is the keyboard profile name (see 
Figure 97 on page 143) 

• DISPLAY MODE. The value selected depends on the application program you 
want to use at the remote TCP/IP node. If it is a full-screen application, 
BLOCK is the best choice 

• LOCAL ECHO. If you choose YES, the OC/TELNET FS will display input data 
at your terminal 

• NEW LINE. Defines the meaning of the <NL> control code sent on the 
remote system: 

- YES. OC/TELNET FS will send the ASCII carriage return and line feed 
character 

- NO. OC/TELNET FS will send only the ASCII carriage return character 

• AUTOWRAP. You can enable the autowrap facility on your terminal 

• SHIFT LOCK. Determines the automatic translation from lower case to upper 
case when transmitting data to the remote system 

• COMMAND PREFIX. Defines the prefix character of input data that the 
OC/TELNET FS has to interpret as a terminal mode command 

• AUTO KEYBOARD UNLOCK. Specifies whether the system will automatically 
unlock your keyboard after an input operation 

• VERTICAL CURSOR MOVEMENT. Defines the vertical cursor movement to be 
used: 
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- NEW. Cursor will be moved to the column corresponding to the new 
cursor position 

- DATA. Cursor will be moved to the column on the new row nearest the 
new cursor position that contains some data 

- LEFT. Cursor will always be moved to column one 

• HORIZONTAL CURSOR MOVEMENT. Defines the horizontal cursor movement 
to be used: 

- NEW. Cursor will be meved te the column corresponding to the new 
cursor position 

- DATA. Cursor will be moved to the column on the new row nearest the 
new cursor position that contains some data 

• CURSOR MOVEMENT SEQUENCE. This value depends en the editor you want 
to use on the remote system: 

- SINGLE. Normal cursor movement 

- EDT. Cursor will have to interact with DEC'S EDT editor 

- VI. Cursor will have to interact with a VI editor on a UNIX system (for 
example, AIX or SUN) 
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TRANSLATION TABLE INFORMATION 


TRANSLATION TABLE => ASCII 


FIRST ENTRY 


=> 00 


PE 1= 
PE 7=UP 


DEFINITION 


2 = 

8=DOWN 



ASCII 


EBCDIC 


NUL 

00 

=> 

00 

NUL 

SOH 

01 

=> 

01 

SOH 

STX 

02 

=> 

02 

STX 

ETX 

03 

=> 

03 

ETX 

EOT 

04 

=> 

37 

EOT 

ENQ 

05 

=> 

2D 

ENQ 

ACK 

06 

=> 

2E 

ACK 

BEL 

07 

=> 

2F 

BEL 

BS 

08 

=> 

16 

BS 

HT 

09 

=> 

05 

HT 

LF 

OA 

=> 

25 

LF 

VT 

OB 

=> 

OB 

VT 

FF 

OC 

=> 

OC 

FF 

CR 

OD 

=> 

OD 

CR 

SO 

OF 

=> 

OE 

SO 

SI 

OF 

=> 

OF 

SI 

3= 

=END 

4= 


5= 

9= 


10= 


11= 


DEFINITION 


6 = 

12=END 


Figure 218. Translation Table Sample 

This panel lets you modify the active translation table simply by typing over the 
EBCDIC predefined values. The translation between ASCII and EBCDIC 
characters is made automatically by OC/TELNET FS. 
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KEYBOARD DEFINITION PANEL 


The following key definitions are currently active during terminal mode: 

ENTER ===> SEND * <NL> 

CLEAR => CLEAR 
PAl => BREAK 
PA2 => RESHOW 
PAS => 

PFl ==> SEND <ESC> OP * 

PF2 ==> SEND * <ESC> OQ 

PF3 ==> SEND * <ESC> OR 

PF4 ==> SEND * <ESC> OS 

PF5 => SEND <ESC> 

PF6 => CONTROL 
PF7 ==> SEND * <HT> 

PF8 ==> SEND C C 
PF9 ==> SEND Z 
PFIO ==> SEND <ESC> Op 
PFll ==> SEND * 

PF12 => END 

PF 1= 2= 3=END 4= 5= 6= 

PF 7=UP 8=DOWN 9= 10= 11= 12=END 


Figure 219. Keyboard Definition Sample 

This panel allows for modification of the keyboard mapping chosen in the 
Terminal Setup Options Panel (see Figure 217 on page 289 ). Just enter the new 
values required and press the 'enter' key. 
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Once your environment is set up according to your needs, you can initiate a 
TELNET connection to a TCP/iP node by specifying its IP address or hostname as 
defined in the HOST fiie (refer to 10.2.2.3, “HOSTS Fiie” on page 138). 


HOST SELECTION PANEL 


This Panel allows you to specify the name or address of the 
host system to be accessed via the TCP/IP network. Once the 
connection has been established, you must log on to the host 
system as if your terminal were physically connected to it. 


ENTER PARAMETER BELOW: 

HOST => aix320 

PORT => (Optional) 


PE 1= 2= 

PE 7= 8= 


3=END 4= 5= 6= 

9= 10= 11= 12=END 


Figure 220. Host Selection Sample 

• HOST. Specifies the name or the iP address (in dotted decimai format) of the 
remete host to be accessed. 

• PORT. Specifies the port number of the remote TELNET server. This 
parameter is optionai; if yeu omit it, OC/TELNET FS wiii take the defauit 
vaiue (23). 
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Figure 221 shows the result of a TELNET connection to the AIX TCP/IP Telnet 
Server. You are now in a position to log on to AIX as if your terminal was an 
ASCII terminal emulating a DEC VT100 terminal (refer to the terminal setup in 
Figure 217 on page 289). 


IBM AIX Version 3 for RISC System/6000 

(C) Copyrights by IBM and by others 1982, 1991. 

login: root 


-k 

* Welcome to IBM AIX Version 3.2! * 

* -k 

■k -k 


* Please see the README file in /usr/lpp/bos for information pertinent to * 

* this release of the AIX Operating System. * 

* -k 

■k -k 

■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 


Last login: Fri Jul 26 08:05:26 NET 1996 on hft/0 
root@aix320: / > 


Figure 221. AIX Welcome Menu Sample 

After having logged in as the 'root' user, the contents of the '/usr/oc/sna/etc' 
directory are displayed as in the figure below. 


root@aix320: 

/usr/oc/sna/etc >ls 

-1 





total 560 








-i:wxr-xr-x 

1 root 

system 

15910 

Sep 

5 

1994 

cfgtext 

-i:w-r—r— 

1 root 

system 

42 

May 

8 

12:45 

ockeys 

-i:w-r—r— 

1 root 

system 

42 

May 

8 

12:43 

ockeys.080596 

- 2 rw-r—r— 

1 root 

system 

53654 

Jul 

12 

09:10 

octermcap 

-rw-r- 

1 root 

system 

508 

Jul 

22 

08:02 

opt.err 

~rw~r - 

1 root 

system 

508 

Jul 

31 

07:26 

opt.err.occl 

~rw~r - 

1 root 

system 

508 

Jul 

25 

09:46 

opt.err.vm_via3174 

- 2 rwxr-xr-x 

1 root 

system 

15328 

Jul 

12 

09:10 

options 

-i:w-r—r— 

1 root 

system 

444 

Jul 

31 

07:20 

options.occl 

-rw-r —r— 

1 root 

system 

399 

Oct 

5 

1995 

options.ocs95.cfg 

-i:wxr-xr-x 

1 root 

system 

11143 

Sep 

5 

1994 

options.org 

-rw-r—r— 

1 root 

system 

311 

Jul 

15 

11:54 

options.vm_via3174 

-i:w-r—r— 

1 root 

system 

53591 

Nov 

24 

1994 

saveoctermcap 

-i:w-r—r— 

1 root 

system 

15379 

Nov 

24 

1994 

savetstext 

-i:w-r—r— 

1 root 

system 

20555 

Jul 

12 

09:00 

tstext 

- 2 rw-r—r— 

1 root 

system 

18108 

Jul 

12 

08:37 

tstextp 


Figure 222. OC/TELNET FS AIX Emulation Sample 
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Chapter 23. OCS II Telnet Server Operation and Examples 


23.1 General Considerations 

The OCS II Telnet Server allows you to log on to VSE from a TCP/IP terminal, 
thereby emulating a 3278 terminal. This emulation is strictly controlled by the 
octermcap file, usually resident in the /usr/oc/sna/etc directory of your RISC/6000 
(see 12.4.4, “System Wide Configuration Options” on page 168 ). This file 
contains some terminal profiles describing the characteristics of a number of 
popular ASCII terminals. If required, new entries for additional terminal types 
can be added to this file. For more details refer to OCS II Telnet Server 
Manager, 350-0193-101. 

Before you can log on to VSE/ESA, the OCS II Telnet Server needs to be active, 
that is, running as a process on the RISC/6000 OCS II Gateway (please refer to 
Chapter 13, “OCS II Gateway Operation” on page 189). 


23.2 Operation Examples 

To establish connection to the VSE host, the standard TELNET command can be 
used: 


telnet host port 


where: 

• host = host name or IP address of the OCS II Telnet Server. This value must 
match the IP addresses and the host names defined in AIX TCP/IP and the 
parameter contained in the HOSTS file (see Figure 91 on page 139). Or you 
have provided a Domain Name Server to resolve the host name. 

• port = OCS II Telnet Server port number. This value must match the number 
specified in OCS II Telnet Server customization panel (see Figure 127 on 
page 171). We have used the TCP/IP standard TELNET port number (23) for 
the VSE TELNET. The AIX TELNET port number has been changed to (2023), 
please refer to 12.6, “Set up Alternative Ports for AIX TELNET and FTP 
Servers” on page 186 for details. Also refer to Figure 127 on page 171 for 
the matching value in OCS II configuration. 

The figure below shows a Telnet session from a TCP/IP station to VSE using OCS 
II Telnet Server. 


[C:\]telnet aix320 


Figure 223. Example of Connecting to the OCS II Telnet Server 
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23.2.1 Telnet Server Welcome Panel 

The panel in Figure 224 shows that OCS II Telnet Server is ready for connecting 
to VSE. Only the 'enter' key needs to be pressed at this stage. 


OpenConnect (R) TELNET Serri/er - OCS II RISC/6000, V3.7.5 

*'>'r*:*r*7'r*:*:*'>'r*:*r*7'r*:*r*'>'r**'*^7'r*:*:*'>'r*:*r*7'r*:*r*'>'r*:*r'*^7'r*:*:*'>'r*:*r'*^7'r*:*r*'>'r*:*r'*^7'r*:*r*'>'r*:*r*7'r*:*r*'>^ 

* Welcome to the ITSO version of CpenConnect Systems TELNET Server * 

-k 


* OpenConnect Systems * 

* 2711 LBJ Ereeway, Dallas, Texas 75234 * 

* tIt 

* OpenConnect Systems offers a complete line of hardware and software * 

* products that provide connectivity between IBM Mainframe/Midrange systems * 

* and TCP/IP networks. * 

* tIt 

* For technical assistance contact Customer Support: * 

* Tel: (214)888-0678 Eax: (214)888-0680 Internet: support@oc.com * 

* BBS: (214)888-0676 * 

* tIt 

* For information about our other connectivity solutions contact Marketing: * 


* Tel: (214)484-5200 Fax: (214)888-0688 Internet: info@oc.com * 

* tIt 

* NOTE: This display screen can be modified by your Systems Administrator * 

* to contain site specific information. A command called <:info<t is * 

* provided to redisplay this screen for subsequent viewing. * 


Press RETURN to accept command, ESC to erase command, or ? for help. 
TS> ! vt220,3278 


Figure 224. OCS II Telnet Server Welcome Panel 

The prompt line TS> lvt220,3278 has the following meaning: 

• '!' is the Telnet Server execute character 

• vt220 Is the negotiated terminal type. This parameter correlates to the setting 
of the NEGTERM value In OCS II Gateway customization (see Figure 127 on 
page 171). If this value Is set to Y the negotiated terminal type Is displayed 
and this entry is used to access the corresponding entry in the octermcap 
file. If you have set It to N, the first entry of the octermcap file Is taken. 

• 3278 Is the emulation requested. This version of OCS II Telnet Server 
emulates only two host terminals, 3278 and 5250. 
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23.2.2 Telnet Server Commands Panel 

If or cmds is entered after the welcome panel, the list of available commands 
as shown in Figure 225 is displayed. 


TS> 

TS execute 

bye I exit 

clients 

cmds I ? 

config 

default 

hat 

help 

info 

keycode 

ocadmin 

reboot 

refresh 

reread 

sac 

service 

showterm 

spy I 

status 

termcap 

trace 


character is C!C and erase character is CESCC. 
quit - Exit TELNET Serm/er Manager. 

- Display information about current sessions. 

- Display TELNET Server Manager commands (this screen) 

- Display configuration information. 

- Prompt with default command line. 

- Display Host Access Table entries. 

- Display TELNET Server Manager help screen. 

- Display TELNET Server Manager banner screen. 

- Enter key interpret mode. 

- Enter OCADMIN administration mode. 

- Gateway remote reboot facility. 

- Refresh Session Access Control configuration. 

- Re-read TELNET Se 2 ver support files. 

- Display Session Access Control info 2 miation. 

- Display available services. 

- Display terminal names defined in octermcap file. 

- Spy Trace facility. 

- Display TELNET Server status. 

- Display octemcap file entry or mnemonic. 

- OCADMIN trace facility. 


Figure 225. OCS II Telnet Server Commands 

A short description of the commands follows; for more details refer to the OCS II 
Telnet Server Manager, 350-0193-101. 

• bye. Closes the connection with OCS II Telnet Server. 

• clients. Gives a list of clients connected to OCS II Telnet Server with their 
attributes such as IP address, port number, as shown in Figure 226 on 
page 299. 

• config. Reads the configuration values of the OCS II Telnet Server in the 
files: 

- features. Internal OCS II Telnet Server file. Its contents change according 
to the feature of the TELNET product used. 

- sna_bin. ASCII file created automatically when saving the values entered 
in the occonfig exec (see 12.4.8, “Save Configuration File Set” on 

page 183). 

- options. This file can be customized by just editing and changing the 
values inside. It contains parameters about OCS II Telnet Server and is 
an alternative method to customizing OCS II Telnet Server without using 
the occonfig utility but was not used or tested in our implementation. 

Figure 227 on page 299 shows an example. 

• default. OCS II Telnet Server prompts the default command line (for example, 
TS> ivtl 00,3278). 
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hat. Reads the contents of the Host Access Table file (tstext). This option was 
tested in our environment for two functions. One is to let TCPCL3 bypass the 
Weloome Panel, and the other is to deny access to all host except TCPCL3. 
The HAT table is shown in Figure 228 on page 299. 

help. Displays OCS II Telnet Server help about emulation servioe as shown 
in Figure 235 on page 303. 

info. Displays OCS II Telnet Server welcome panel. 

keycode. Enters the terminal in keycode mode. When you press a key, ASCII, 
octal, decimal and hexadecimal code are displayed. To exit and return to the 
normal mode just press Shift+q. Figure 229 on page 300 shows an 
example. 

ocadmin. This command is used to enter the password protected 
administration (ocadmin) mode. The kill, reboot,refresh, reread, spy, and 
trace commands are restricted for use under ocadmin mode. 

reboot. Reboots the OCS II Gateway from your terminal. The ocadmin mode 
must be set to perform the reboot. 

refresh. The refresh oommand allows to ohange and reread the Session 
Access Control (SAC) configuration file without rebooting the gateway. The 
ocadmin mode must be set to perform the refresh. 

reread. Rereads the OCS II Gateway configuration files without the necessity 
to reboot the client. This is useful when you ohange these files (for example, 
ctermoap) when the Telnet session is already established. 

sac. The ourrent SAC groups, pools, or TN3270E terminal and printer LU 
associations are displayed. 

service. Displays the services available in OCS II Telnet Server as shown in 
Figure 231 on page 300. 

showterm. Displays the terminal type entries in the octermcap file as shown 
in Figure 232 on page 301. 

spy. SPY activates a TELNET Server trace facility. The trace facility performs 
debugging of communioation between OC/TELNET Server and 

1. Any TELNET client operating on a TCP/IP host. 

2. OC/TN3270 terminal emulation client operating on a TCP/IP host. 

status. Displays the OCS II Telnet Server status as shown in Figure 233 on 
page 301. 

termcap. fer/n Displays the contents of the term entry in octermacp file as 
shown in Figure 234 on page 302. 

trace. The trace command provides an interface to the OCSNA trace facility 
to initiate and/or terminate an OCSNA trace from the TELNET Server 
Manager command line. If entered with parameter -x a panel with the code 
level is displayed as shown in Figure 230 on page 300. For more details on 
this argument please refer to OCS II Telnet Server Manager, 350-0193-101. 



23.2.3 Display OCS II Telnet Server Clients 


TS> clients 


Service 

IP Address 

Port# Socket# PU Name 

LU Name 

LU# State 

IT 

IL 

Spy 

Tsmgr 

192.61.100.83 

1026 

6 




1 


* tIt 

•jlr * 

tn3270 

192.61.100.81 

1024 

4 

IPFP2209 

IPFT2S9M 

13 

1 

* 

tIt * 

•jlr 

3278 

192.61.100.199 

1026 

7 

IPFP2209 

IPFT2S9N 

14 

1 

* * 

tIt * 

tIt •*: 

Configured sessions: 

: 8 

Active 

sessions: 

: 3 







Figure 226. Display Ciients Example 


23.2.4 Display OCS II Telnet Server Configuration 


TS> config 
Service 

Feature Option Config Result 

USERS_TELNET 


16 

8 

k-kk 

8 

USERS_3278 


16 

16 

3 

3 

USERS_5250 


0 

0 

0 

0 

USERS_TN3270(E) 

16 

8 

3 

3 

USERS_TN5250 


16 

•k-k it 

0 

0 

USERS_TSPASS 


16 

k-kk 

tIt * tIt 

8 


Buffer 

size count 

cac 

hac 

TypeO 

128 

8 

1 

3 

Typel 

256 

12 

0 

5 

TYpe2 

1024 

4 

0 

1 

Type 3 

4096 

2 

0 

1 

Type 4 

8188 

8 

1 

1 

Memory 

cac hac 





12 2 2 

264 1 1 


Temcap RAM Disk size = 65536, used = 29329 


Figure 227. Display Configuration Example 


23.2.5 Display OCS II Telnet Server HAT Table 


TS> hat 

Name IP address IP mask Port Pmask 


tcpcl3 192.61.100.199 OxFF.FF.FF.FF 0 0x0000 

allhosts 0.0.0.0 0.0.0.0 0 0 


Figure 228. Display HAT Tabie Exampie 
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23.2.6 Display OCS II Telnet Server Keycodes 


TS> keycode 

You entered key detect mode. Type Q to exit. 


Char: <'" 

' [> Decimal: 

27 

Hex: OxlB 

Octal: 

\033 

Char: < 

[ > Decimal: 

91 

Hex: 0x5B 

Octal: 

\133 

Char: < 2> Decimal: 

50 

Hex: 0x32 

Octal: 

\062 

Char: < 

8> Decimal: 

56 

Hex: 0x38 

Octal: 

\070 

Char: < 

~> Decimal: 

126 

Hex: 0x7E 

Octal: 

\176 

Char: < Q> Decimal: 

81 

Hex: 0x51 

Octal: 

\121 


Figure 229. Display Keycodes Exampie 


23.2.7 Display OCS II Telnet Server 'trace" Facility 


TS> trace -x 

-> PID: 6237 Start Time: Thu Jul 19 08:11:50 1996 
-> Current Trace Log Filename: L0421152625 
-> Last 2 trace files being kept. 

-> Maximum byte size of Trace Files is: 1046576 


Lvl Description 


100 TCP/IP Control Trace Level 

102 Dump PS TCP/IP Packets 

104 Dump FTP TCP/IP Packets 

106 Dump RSH TCP/IP Packets 

108 Dump Short Format IFBUF Packets 

200 DLC Control Trace Level 

202 Dump DLC Packets (Long format) 

299 Full DLC Trace Level 


Lvl Description 


101 Dump ALL TCP/IP Packets 
103 Dump Telnet TCP/IP Packets 
105 Dump IP Route TCP/IP Packets 
107 Dump Internal IFBUF Packets 
199 Full TCP/IP Trace Level 
201 DLC Read/Writes Trace Level 
203 Dump DLC Packets (Short fo 2 miat) 
300 SUP Malloc Trace Level 


Figure 230. Display 'trace' Example 


23.2.8 Display OCS II Telnet Server Services 


TS> service 

5250 is default, available services are: 

3278 - TELNET Server/IBM 3278 display station emulation. 

5250 - TELNET Server/IBM 5270 display station emulation. 

tn3270 - TN3270 client support. 

tn3270E - TN3270E client support. 

tn5250 - TN5250 client support. 

local - local TELNET redirector support. 


Figure 231. Display Services Exampie 


300 TCP/IP for VSE/ESA 












23.2.9 Display OCS II Telnet Server Terminal Types 


TS> showterm 
Terminals known to 

TELNET Server: 

ANSI 

FALCO-925-32 

APOLLO 

FALCO-925-32W 

ATT-4418 

FALCO-925W 

ATT-4425 

HP-2640 

ATXENIX 

HP-2640C 

DATA-GENERAL-210 

HP-9000 

DATA-GENERAL-410 

HP-9000C 

DATA-GENERAL-41OA 

IBM-3151 

DEC-VTIOO 

IHM-3164 

DEC-VTl00-32 

IHM-3179-2 

DEC-VTIOO-C 

IBM-3179-2-E 

DEC-VTIOOC 

IBM-3179-2-P 

DEC-VTIOOG 

IBM-3196-Al 

DEC-VTl02 

IBM-3196-A1-E 

DEC-VT220 

IBM-3196-A1-P 

DEC-VT220-8 

IBM-3278-2 

DEC-VT300 

IBM-3278-3 

DEC-VT300-8 

IBM-3278-4 

DEC-VT320 

IBM-3278-5 

DEC-VT320-132 

IBM-3279-2 

DEC-VT320-8 

IBM-3287-1 

DEC-VT52 

IBM-3477-FC 


IBM-3477-FC-E 

TEKTRONIX-4115 

IBM-3477-FC-P 

TEKTRONIX-4115N 

IBM-3477-FG 

TEKTRONIX-4205 

IBM-3477-FG-E 

TEKTRONIX-4224 

IBM-3477-FG-P 

TEKTRONIX-4316 

IBM-5251-11 

TEKTRONIX-4316X 

IBM-5251-11-E 

TEKTRONIX-4324 

IBM-5251-11-P 

TELEVIDEO-925 

IBM-5292-1 

VISENTECH-VS230-8 

IBM-5292-1-E 

WYSE-50 

IBM-5555-B01 

WYSE-60 

IBM-5555-B01-E 

XTERM 

IBM-5555-C01 

allhosts 

IBM-5555-C01-E 

dgbasic 

LINK-125 

tekbasic 

LSI-ADM-3A 

vtlOO 

LSI-ADM-3A+ 

vt220 

LSI-ADM-5 

vt220basic 

MACPLUS 

vtbasic 

PCENH 


PCXTC 


SUN 



Figure 232. Display Terminal Types Example 


23.2.10 Display OCS II Telnet Server Status 


TS> status 

TELNET Server finds everything ok 


Figure 233. Status Display Example 
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23.2.11 Display Terminal Characteristics 


TS> termcap vtlOO 
vtlOO: 

tc=DEC-VT100: 

dl|DEC-VT100|VT100|vtl00|DEC VtlOO capabilities: 
ku=\E[ACUp Arrows: 
kd=\E[BCDown ArrowC: 
kr=\E [C<:Right Arrow<:: 
kl=\E [D<^Left ArrowC: 
kO=\EOP<^PFl<:: 
kl=\EOQ<:PF2<:: 
k2=\EOR<:PF3<:: 
k3=\EOS<:PF4<:: 
ta=''ICTabC: 
cs=| : 

fO=\EOP<^PFl<: I \EltEsc IC: 
fl=\EOQ<:PF2<: I \E2tEsc 2‘^ : 
f2=\EOR<^PF3<: I \E3tEsc 3<:: 
f3=\EOSCPF4<: I \E4^ESC 4<:: 
tc=vtbasic: 

dOIvtbasicI DEC vt basic capabilities: 
cr=^MCReturn<:: 
nl=^ J: 

cl=\E[;H\E[2J: 
cm=\E[%i%d;%dH: 
ce=\E[K: 
cd=\E[J: 
se=\E [m: 
hl=\E[lm: 
so=\E[7m: 
uc=\E[4m: 
bk=\E[5m: 


Figure 234. Display Terminai Characteristics Example 


23.2.12 OCS II Telnet Server Help Information 

After having started the TELNET session, help infermation is available by 
pressing the appropriate keys as defined in the 'octermcap' file. For example, a 
PS/2 client, using termtype vt220 and a 3278 emulation, gets help Information by 
pressing Shift+PF5; the result will be the screen shewn in Figure 236 on 
page 303. 
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3278 Key 

»> TELNET 
Key Cap 

Server 3278 Help Screen «< 
3278 Key 

Key Cap 

ENTER 

Return 

DOUBLE LEFT ARROW 


RETURN 

''J 

RIGHT ARROW Right Arrow 

RESET 

^a 

DOUBLE RIGHT ARROW ^b 


HELP TOGGLE 

Help 

UP ARROW 

Up Arrow 

TERM RESET 

Esc tty 

DOWN ARROW 

Down Arrow 

EXIT SESSION 

Ctrl-3 XX 

INSERT 

Ins Here 


Esc XX 

DELETE 

Remove 

EXIT TO TS MANAGER 

Ctrl-3 xe 

FIELD MARK 

^k 


Esc xe 

L25 TOGGLE 

-'y 

CLEAR 

Ctrl-3 z 

SYS REQ 

Select 

REPAINT 

Ctrl-3 r 

ATTN 

Find 

ERASE EOF 

Prev Scr 

CUR SEL 

Esc c Cr 

ERASE INPUT 

Next Scr 

DUP 

^d 

BACKSPACE 

Rubout 

PAl 

Ctrl-3 al Cr 

TAB 

Tab 

PA2 

Ctrl-3 a2 Cr 

BACK TAB 

^e 

PA3 Ctrl-3 a3 Cr 

HOME 


PFl PFl 


IF,FT ARROW 

Left Arrow 

PF2 

PF2 

Server: OCS II RISC/6000, V3.7.I 

Socket#: 5 PU: IPFP2209 LU: IPFT2S90 

Terminal: vt220 

Attributes: Blink Underline Reverse Highlight Colors 

Not Supported 

Press Space Bar for more help . . 

.. . [screen 1 of 2[. 



Figure 235. Telnet Server Sample 


TS> help 

OpenConnect (R) TELNET Server - Help 

To start a TELNET Se 2 ver 3278 session: 

TS> ! term_type ,3278, auto_detect, LU, PU_naine 

To start a TELNET Se 2 ver 5250 session: 

TS> !term_type,5250,auto_detect 

Where: tenn_type - Te 2 nninal entry name defined in the octermcap file. 

3278 or 5250 - Emulation (service) type. 

auto_detect - Auto-detect Carriage Return flag (default=Y). 

LU - LU name or number, 3278 only (default=first available) . 

PU_name - PU name, 3278 only (default=first available) . 

To start a 3278 session using a Wyse 50 terminal, with auto-detect CR, 
through LU 4 of a PU named PU2 enter: !wyse50, 3278,, 4,PU2 

To start a 5250 session using a vt220 terminal, without auto-detect CR, 
enter: !vt220,5250,N 

No other services are currently supported by this version of the TELNET 
Server. Contact your system administrator for more detailed documentation. 

Figure 236. Telnet Server Help Sample 
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Chapter 24. OC/SAM Programming 


The OC/SAM software packet allows a VSE system to communicate with a local 
area network using an OpenConnect Server. The program on the VSE system 
communicates with a partner program on the LAN, using either the User 
Datagram Protocol (UDP) or Transmission Control Program (TCP). Program 
development using UDP can be either single or multi-user. Program 
development using TCP can be either single or, if using VTAM LUO, multi-user. 

The Socket Access Method provides the entry point into the network, the 
so-called socket, which is used by the application program to communicate with 
the partner program. The network complexity is handled by the OC/SAM 
software product. The only programming required in the VSE program is for the 
protocol established by the partner program. 

The interface between the mainframe application and the OpenConnect Server is 
the APPL definition (VTAM), the LU definition (VTAM), or channel address (GTO). 
All transactions flow through this single path. There can be any number of 
partners on the LAN interfacing to the VSE application through this single path. 
This eliminates the tying up of more than one resource (LU) on the OpenConnect 
Server to run a multi-user configuration. 

Before writing your own socket programs you should study the sample programs 
provided in TCPOCS.SAMSMP. 


24.1 TCP/IP Application Programming Tutoriai 


24.1.1 Network Programming Overview 

Each process that uses TCP/IP communication services at a given node is 
assigned a unique port number. This process is called a TCP/IP server and can, 
from a conceptual point of view, be 'called' by any TCP/IP client using that port 
number. The server uses a port number that all potential clients know. A TCP/IP 
client process typically uses one port to establish a communication with the 
server and another one to request services and transfer data. 

The TCP/IP communication software from OCS supports the sockets network 
programming API. Sockets provide a network programming API that is very 
similar to do input/output to local devices. The sockets API is currently by far the 
most commonly used API for network programming in the TCP/IP environment. 


24.1.2 Socket Programming 

The socket access method supplied by OCS supports two different types of 
sockets: 

1. Datagram sockets: These are sockets that can be used to communicate 
using the User Datagram Protocol (UDP). Datagram sockets support an 
unreliable, datagram form of data transfer in which individual user 
datagrams can be sent from one socket to another. 
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2. Stream Sockets: These are sockets that can be used to communicate using 
the Transmission Control Protocol (TCP). Stream sockets support a 
connection-oriented form of data transfer where streams of data can be sent 
from one socket to another over a TCP connection. 


24.1.3 Socket Addresses 

To establish a TCP/IP session, the sockets communication API functions need 
address information about the communication partners. A socket address is 
comprised of: 

1. An Internet address: a four-byte integer value containing the internet 
address, in binary format, of the host in which the process is running. A 
client process must know the internet address of the host on which the 
server is running. 

2. A Port: a two-byte integer value identifying the port number assigned to the 
process. A client must know the port number that the server is using. A 
client typically asks the communication software to supply it. 


24.1.4 Application Protocols 


24.1.4.1 Connectionless Application Protocol 

A client/server application that implements a connectionless application protocol 
uses datagram sockets to communicate using UDP. Figure 237 on page 307 
shows the sequence in which the API functions are typically issued in an 
application that uses a connectionless protocol. 
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Serrver Process 


Client Process 

socket_setup 


socket_setup 

connect_to 


connect_to 

wait until data 



received from client 



User Datagram 

send_to 

process request 



send_to 

User Datagram 

receive_f rom 

disconnect_frcm 


disconnect_frcm 





Figure 237, Typical Sockets API Functions for UDP 


Steps performed by a connectionless server: 

1. The server issues several SAM functions to provide protocol information that 
will eventually be required to support communication between the client and 
the server. 

2. The server issues a 'connect_to' function, to provide his own port number. 
The internet address of the own host is returned by this function. 

3. The server then issues a 'receive_from' function that allows the server to 
accept incoming data from a client. The 'receive_from' function causes the 
server to wait until data arrives from any client that wishes to use the 
services of the server process. 

4. When an incoming user datagram arrives from a client, the server performs 
any required processing. The protocol control information included in the 
incoming user datagram includes the client host's internet address and the 
port number used by the client process on that host. 

5. The server can then reply to the client by issuing one or more 'send_to' 
functions. The 'send_to' function references the client's socket address that 
was received in the previous step. 

6. To terminate the connection with the port number that was provided in the 
'connect_to' request, the 'disconnect_from' function is used. 

Steps performed by a connectionless client: 

1. The client issues the same setup functions as the server. 
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2. The client issues the 'connect_to' function providing his own port number. 

3. The client issues a 'send_to' function to send a user datagram to the server. 
The client must know the socket address of the server. 

4. If the client expects to receive data from the server, he issues a 
'receive_from' function that causes the client to wait until data arrives from 
the server. 

5. To end the connection a 'disconnect_from' is issued. 

The socket setup is comprised of several SAM functions issued in sequence to 
initialize the interface with the OpenConnect server: 

1. Get work area: allocate storage areas that will be used by this session. 

2. Set socket options: set up the options that will be used during program 
execution (for example, request tracing). 

3. Set net by LU: identifies the LU that will be used to communicate with the 
OpenConnect server. 

4. Set ACB by name: set the ACB name that will be used to identify your 
application to VTAM. 

5. Set protocol by name: Set the type of protocol (UDP or TCP) that will be used 
to communicate with the partner on the network. 

6. Session start: establish a connection from the ACB to the LU of the 
OpenConnect server. 

Note: This SAM function does not establish sessions to TCP partner 
programs, only to the OC server. 

When the network resources are no longer required by the program, the 
program terminates the socket in an orderly fashion: 

1. Session end: terminate the session with the LU on the OpenConnect server. 

2. Close all: this function closes any internal files and file buffers. 

3. Put work area: all storage areas allocated by the 'Get work area' function 
are released. 


24.1.4.2 Connection-oriented Application Protocols 

A client/server application that implements a connection-oriented application 
protocol uses stream sockets to communicate using TCP. Figure 238 on 
page 309 shows the sequence in which the API functions are typically issued in 
an application that uses a connection-oriented protocol. 
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Serrver Process 

Client Process 

socket_setup 

socket_setup 

listen_on_j»2rt 


accept_session 


wait until connection re¬ 
quest received from client 


Connection requests 

establish_session 

and acknowledgennents 


receive_from TCP segment 

send_to 

process request 


send_to TCP segiTBnt 

receive_from 

close_session 

close_session 




Figure 238. Typical Sockets API Functions for TCP 

Steps performed by a connectien-oriented server: 

1. Server issues functions required for setting up the interface. 


2. The server issues a listen function that links the server application to a 
specific port number. 

3. The server issues an 'accept_session' to indicate that the server is willing to 
accept a connection request from a client. 

4. The 'wait until connection' request can be done either cn the 
'accept_session' or the 'receive_from' function, depending on the cpticns 
specified. 

5. The server performs the processing required by the application and issues a 
'send_to' functicn that allows the server tc send data to the client. 

6. Before the server terminates, he issues the 'close_session' request. 

Steps perfcrmed by a ccnnection-oriented client: 
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1. Set up sockets to initialize the communication interface. 

2. The client issues an 'establish_session' function to set up a session to the 
server. The client has to provide the socket address information of the server 
in this function. 

3. The client uses a 'sent_to' function to send data to the server over the 
established TCP connection. 

4. To end the session created by 'establish_session' the client issues the 
'close_session' request. 


24.2 Running the Sample Programs 

To run the sample programs provided by OC/SAM some preparatory work is 
required: 

• Customize VTAM 

• Adapt the source programs 

• Create a job to execute the programs. All sample programs are assembled 
with the VSE/High Level Assembler (HLASM). 


24.2.1 VTAM Customization 


24.2.1.1 VTAM APPL Definitions 

Before the sample programs can be run, the application names have to be 
defined in the APPL major node. 

Figure 239 is an extract from the complete VTAM APPL provided in the sample 
library member '$VTAMGEN'. 


UDPTESTl APPL AUTH= (ACQ), EAS=2, ACBNAME=UDPTEST1 
UDPTEST2 APPL AUTH=(ACQ),EAS=2,ACBNAME=UDPTEST2 
TCPTESTl APPL AUTH=(ACQ),EAS=2,ACBNAME=TCPTEST1 
TCPTEST2 APPL AUTH=(ACQ),EAS=2,ACBNAME=TCPTEST2 

Figure 239. APPL Definitions for OC/SAM Sampies 

The key definitions and parameters are: 

• UDPTESTn / TCPTESTn APPL entries. APPL entries for the UDP/TCP test 
programs. The key parameters are: 

- ACBNAME. Should be the same as the APPL label. The names must 
match the values specified in the sample programs. 

- EAS=2. Allows two concurrent sessions. 
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24.2.1.2 VTAM LU Definition 

Figure 24 on page 47 lists all LUs we defined In our setup. 

The two LU definitions we used for the OC/SAM sample programs are shown In 
the following figure. 


IPF2S9I 

LU 

LOCADDR=9, DLOGiyDD=OCSLUO, 

C 



ISTATUS=ACTIVE, iyDDETAB=OCSBIND, 

C 



iyDLTAB=VIMyDL, MDLENT=VSELU2A, 

SSCPFI/T=USSSCS, USSTAB=VIMUSSTR 

C 

IPF2S9P 

LU 

LOCADDR=16, DLOGiyDD=(XSLUO, 

C 



ISTATUS=ACTIVE, iyDDETAB=(XSBIND, 

C 



iyDLTAB=VIMyDL, MDLENT=VSELU2A, 

SSCPFI/T=USSSCS, USSTAB=VIMUSSTR 

C 


Figure 240. LU Definitions for the OC/SAM Sampies 


The key parameters are: 

• The LU name. Must match the: 

- LU name In the OCS M Gateway customization (see 5.1.2.4, “VTAM Local 
SNA Major Node” on page 46) 

- LU name In the OC/SAM sample programs 

• LOCADDR. Must match the number used in the OCS II Gateway 
customization (see 5.1.2.4, “VTAM Local SNA Major Node” on page 46) 

• MODETAB and DLOGMOD. Identify the appropriate logmode table entry. We 
used the same table as the OC/FTP Server (see 6.2.2, “VTAM Customization 
on page 66). 


24.2.2 OCS Sample Programs 

Subllbrary TCPOCS.SAMSMP contains program samples for socket 
programming. In order to adapt the programs to your network environment, 
punch them Into the ICCF library. To assemble and run the programs, use the 
sample job $VSEJCL.A provided in library TCPOCS.SAMSMP and modify it 
accordingly. 


24.2.2.1 UDP Sample Programs 

We ran sample programs UDPSBVO and UDPCBVO which use SNA LUO to 
communicate with the OpenConnect Server. 

UDPSBVO Is a TCP/IP server program using UDP to respond to the UDPCBVO 
client. 

UDPCBVO is a TCP/IP client program using UDP to call the UDPSBVO server. 

Both programs are running on VSE/ESA and communicate with each other via 
the OCS 11 Gateway. 

Some of the SAM function calls In the source code have to provide environment 
specific parameters. We modified that code as follows: 

1. For the server UDPSBVO: 
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• GET_WORK_AREA function must use parameter value "DOS" instead of 
"MVS". 

• SET NET BY LU function must specify LU name "IPFT2S9I". 

• SET_ACB_BY_NAME function must specify VTAM application program 
name "UDPTEST1". 

2. For the client UDPCBVO: 

• GET_WORK_AREA function must use parameter value "DOS" instead of 
"MVS". 

• SET NET BY LU function must specify LU name "IPFT2S9P". 

• SET_ACB_BY_NAME function must specify VTAM application program 
name "UDPTEST2". 

The modified source code is then eataloged back into library TCPOCS.SAMSMP. 

Then we assembled and ran the UDP server program using the following job: 


* $$ JOB JNM=UDPSBV0,CLASS=0,DISP=D 

* $$ LST DISP=D,CLASS=A,DEST={,WSTIEBER) 

// JOB UDPSBVO 

// LIBDEF SOURCE,SEARCH=TCPOCS.SAMyiAC 
// LIBDEF OBJ,SEARCH=TCPOCS.SAiyDBJ 
// LOG 

// OPTION LINK 

// EXEC PGiyh=ASMA90, SIZE= (ASMA90,50K), C 

PARN^SYSPARM (DOS) 9 

* $$ SLI MEM=UDPSBVO.A 
/* 

// EXEC PGM=LNKEDT 
/* 

//EXEC ,SIZE=AUTO 
/* 

/& 

* $$ EOJ 


Figure 241. Assemble and Run the UDP Server Program 

When the server program UDPSBVO is ready to aooept olient requests, the 
following message appears on the VSE system console: 

'SOCK$AM/UDPS READY FOR CLIENT' 

Now the client program UDPCBVO oan be assembled and started. 
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* $$ JOB JNiy^UDPCBV0,CLASS=5,DISP=D 

* $$ LST DISP=D,CLASS=A,DEST={,WSTIEBER) 

// JOB UDPCBVO 

// LIBDEF SOURCE,SEARCH=TCPOCS.SAMyiAC 
// LIBDEF OBJ,SEARCH=TCPOCS.SAiyDBJ 
// LOG 

// OPTION LINK 

// EXEC PGiy^ASMA90, SIZE= (ASMA90,50K), C 

PARN^SYSPARM (DOS) 9 

* $$ SLI MEM=UDPCBVO.A 
/* 

// EXEC PGM=LNKEDT 
/* 

//EXEC ,SIZE=AUTO 
/* 

/& 

* $$ EOJ 


Figure 242. Assemble and Run the UDP Client Program 

The programs exchange short notices to test the UDP link and complete without 
further messages. Check the trace entries in the job output to verify that the 
programs communicated successfully. 


24.2.2.2 TCP Sample Programs 

We ran sample programs TCPSBVO, TCPCBVO and TCPSMTP which use SNA 
LUO to communicate with the OpenConnect Server. 

TCPSBVO is a TCP/IP server program using TCP to respond to the TCPCBVO 
client. 

TCPCBVO Is a TCP/IP client program using TCP to call the TCPSBVO server. 

TCPSMTP Is a TCP/IP client program using TCP to send mail to a standard 
TCP/IP SMTP (Simple Mail Transfer Protocol) server. 

TCPSBVO and TCPCBVO are running on VSE/ESA and communicate with each 
other via the OCS 11 Gateway. 

Some of the SAM function calls In the source code have to provide environment 
specific parameters. We modified that code as follows: 

1. For the server TCPSBVO: 

• GET_WORK_AREA function must use parameter value "DOS" instead of 
"MVS". 

• SET NET BY LU function must specify LU name "IPFT2S9I". 

• SET_ACB_BY_NAME function must specify VTAM application program 
name "TCPTEST1". 

2. For the client TCPCBVO: 

• ESTABLISH SESSION function must specify the server IP address, in our 
case X'C03D6451' (192.61.100.81). 

• GET_WORK_AREA function must use parameter value "DOS" instead of 
"MVS". 


Chapter 24. OC/SAM Programming 313 





• SET NET BY LU function must specify LU name "IPFT2S9P". 

• SET_ACB_BY_NAME function must specify VTAM application program 
name "TCPTEST2". 

The modified source code is then cataloged back into library TCPOCS.SAMSMP. 
Then we assembled and ran the TCP server program using the following job: 


* $$ JOB JNiy^TCPSBVO,CLASS=0,DISP=D 

* $$ LST DISP=D,CLASS=A,DEST={,WSTIEBER) 

// JOB TCPSBVO 

// LIBDEF SOURCE,SEARCH=TCPOCS.SAMyiAC 
// LIBDEF OBJ,SEARCH=TCPOCS.SAiyDBJ 
// LOG 

// OPTION LINK 

// EXEC PGiyk=ASMA90, SIZE= (ASMA90,50K), 

C 

PARN^SYSPARM (DOS) 9 

* $$ SLI MEM=TCPSBVO.A 
/* 

// EXEC PGM=LNKEDT 
/* 

//EXEC ,SIZE=AUTO 
/* 

/& 

* $$ EOJ 



Figure 243. Assemble and Run the TCP Server 


When the server program TCPSBVO is ready to accept client requests, the 
following message appears on the VSE system console: 

'SOCK$AM/TCPS READY FOR CLIENT' 

Now the client program can be assembled and started. 


* $$ JOB JNM=TCPCBV0,CLASS=5,DISP=D 

* $$ LST DISP=D,CLASS=A,DEST={,WSTIEBER) 

// JOB TCPCBVO 

// LIBDEF SOURCE,SEARCH=TCPOCS.SAMyiAC 
// LIBDEF OBJ,SEARCH=TCPOCS.SAiyDBJ 
// LOG 

// OPTION LINK 

// EXEC PGiyh=ASMA90, SIZE= (ASMA90,50K), C 

PARIM^SYSPARM (DOS) 9 

* $$ SLI MEiy^TCPCBVO.A 
/* 

// EXEC PGM=LNKEDT 
/* 

//EXEC ,SIZE=AUTO 
/* 

/& 

* $$ EOJ 


Figure 244. Assemble and Run the TCP Client 

The programs exchange short notices to test the TCP link and complete without 
further messages. Check the trace entries in the job output to verify that the 
programs communicated successfully. 
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TCPSMTP is a batch program which communicates with an SMTP maii server 
program. 

Some of the SAM function caiis in the source code have to provide environment 
specific parameters. We modified that eode as foiiows: 

• ESTABLISH SESSION function must specify the server IP address, in our 
case X'C03D6451' (192.61.100.81). 

• GET_WORK_AREA function must use parameter vaiue "DOS" instead of 
"MVS". 

• SET NET BY LU function must specify LU name "IPFT2S9P". 

• SET ACB BY NAME function must specify VTAM appiication program name 
"TCPTEST1". 

The modified source code is then eataioged back into iibrary TCPOCS.SAMSMP. 

The TCPSMTP program reads maii to be sent from SYSiPT, the input must aiso 
include the standard SMTP control information. A more advanced mail client 
function for VSE is described in the next section. 

To run the TCPSMTP program we submitted the following job: 


* $$ JOB JNiy^TCPSMTP,CLASS=0,DISP=D 

* $$ LST DISP=D,CLASS=A,DEST={,WSTIEBER) 

// JOB TCPSMTP 

// LIBDEF SOURCE,SEARCH=TCPOCS.SAMyiAC 
// LIBDEF OBJ,SEARCH=TCPOCS.SAiyDBJ 
// LOG 

// OPTION LINK 

// EXEC PGiyh=ASMA90, SIZE= (ASMA90,50K), C 

PARM^SYSPARM (DOS) 9 

* $$ SLI MEM^TCPSMTP.A 
/* 

// EXEC PGM=LNKEDT 
/* 

// EXEC ,SIZE=AUTO 
MAIL FRCM:<wacker@aix320> 

RCPT TO:<pram@aix320> 

DATA 

SUBJECT: VSE/aix 

This is a line of data from an SMTP client on the VSE system. 

/* 

/& 

* $$ EOJ 


Figure 245. Assemble and Run the TCPSMTP Mail Client 


Chapter 24. OC/SAM Programming 315 




24.3 SMTP Mail Example 

Based on the TCPSMTP sample program discussed in the previous section, we 
developed an extension to Implement a simple but efficient mall facility for 
VSE/ESA based on TCP/IP SMTP. 

The example described In this chapter works as a standard SMTP mall client 
which delivers mail to standard Internet SMTP mall servers, in order to send 
mail to other Internet users. 

In our test environment we sent mail from the VSE system to users on AIX, OS/2 
and Windows and where the mail can be retrieved using the standard 
TCP/IP-based mall programs on these platforms. 

- Note - 

The programs referred to In this chapter are available on the IBMVSE tools 
disk (managed by VMTOOLS at BOEVM3). 


24.3.1 Mail Example Overview 

A mall system Is typically divided In two parts, the "Message Transfer Agent" 
and the "Message Entry Function". The basic structure of our Implementation is 
illustrated In the following figure. 


VSE/ESA 


Message 

Entiry Function 

RS/6000 

Message 

Transfer Agent 

SMTP Sefcv^er 

OC SAM 

TCP/IP Sockets 

VSE/VTAM 

AIX 


access to 

Internet 


Figure 246. VSE/ESA SMTP Mail Client Structure 


The SMTP mall function works as follows: 

1. The Message Transfer Agent (MTA) receives the mail text and sends It to the 
SMTP server after having added the necessary SMTP protocol Information. 
The MTA is implemented on VSE/ESA using the OC/SAM programming API. 

2. The Message Entry Function (MEF) allows users to enter a mall text and 
send It to the desired recipients by using a PF-key. 

The MEF was implemented as a simple dialog function using the VSE/ESA II 
(Interactive Interface). Figure 247 on page 317 shows an example of how to 
enter mall using the MEF. 
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lESADMMAIL Send a Note 

To: wacker@aix320 prainot@tcpcl3 
Cc: wstieber@aix320 
Subject: VSE/mail 

Hello, 

this is a mail entered via the VSE message entry function. 

The VSE message transfer agent generates the required SMTP 
control cards and sends them to the SMTP server on AIX. 

From there on the SMTP mail servers handle the delivery of the 
mail in the TCP/IP network. 

See you later on OS/2. 


Enter receiver address and your mail. 

PF1=HELP 2=DEL LINE 3=END 4=RETURN 5=SEND 6=ADD LINE 


Figure 247. Entering SMTP Maii on VSE/ESA 

- Note - 

The Message Entry Function (MEF) is not described further in this book; a 
detaiied description is avaiiabie on the IBMVSE toois disk (managed by 
VMTOOLS at BOEVM3). 


24.3.2 Message Transfer Agent 

The Message Transfer Agent (MTA) receives messages via the MEF and sends 

them to an SMTP server program. 

A message consists of: 

1. A message header, containing address information of the sender and the 
recipients and other maii information. 

2. A message body, containing the mail text. 

Our implementation of the MTA supports the following Message Pleader (MFI) 

components (note that all MH component identifiers have to start in column 1): 

MH-Component Comment 

From: Specifies the sender address of the message. Flas to be the first MFI 

component. In our implementation this is inserted by the MEF and 
corresponds to the VSE/ESA user ID. 

To: Specifies the address(es) of the primary recipient(s). At least one user 

has to be specified. Multiple users can be specified separated by 
blanks. 

Cc: Specifies the address(es) of secondary recipient(s), that is the 'carbon 

copy' list. 

Subject: Provides for a comment line which will be displayed by the receiver's 

mail system. 

The message header is ended by a line of dashes ("-"). 

The message body ends with a "." (dot) on the first character position. 
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Taking our example from Figure 247, the following lines are passed to the MTA: 


To: wacker@aix320 pramot@tcpcl3 
Cc: wstieber@aix320 
Subject: VSE/mail 


Hello, 

this is a mail entered via the VSE message entry function. 

The VSE message transfer agent generates the required SMTP 
control cards and sends them to the SMTP server on AIX. 

From there on the SMTP mail servers handle the delivery of the 
rmail in the TCP/IP network. 

See you later on OS/2. 


Figure 248. Message Input to the VSE/ESA Message Transfer Agent 

All necessary SMTP control cards are generated by the Message Transfer Agent. 

To handle the communication with the calling program the message is prefixed 
by an 80-byte Control Buffer, mainly to signal error conditions to the caller. 

The contents of this Mail Control Buffer are listed in the following figure. 


MAILDS 

MAILHD 

DSECT 

DS 

0CL80 

MAIL CB PASSED BY CALLER 

VSE/ESA MAIL HEADER 

MLTAG 

DS 

CL6 

CONSTANT /MAILCB/ 

MLRC 

DS 

H/OC 

RETURN CODE TO CAT,TER 

MLRCOK 

EQU 

X/OOC 

OK 

MLRCSMTP 

EQU 

X/CA/ 

SMTP ERROR 

MLRCSOCK 

EQU 

X/OCC 

SOCK$AM ERROR 

MLRSC 

DS 

H/OC 

REASON CODE 

MLSRC 

DS 

CLl 

MAIL SOURCE (dM MEANS CCMMAREA) 

MLTROPT 

DS 

CLl 

TRACE OPT (=T MEANS TRACE) 

MLOPTFIL 

DS 

CL6 

EMPTY SLOTS 

MLSRCQN 

DS 

CL8 

NAME OF TS QUEUE OF SOURCE 

MLTRQN 

DS 

CL8 

NAME OF TS QUEUE FOR TRACE 

MLDATA 

DS 

0CL13 

DIAGNOSTIC: STRING DATA 

MLSMMSG 

DS 

CL3 

SMTP: MSG NUMBER/ SAM: REQ. 

MLSMUSR 

■k 

DS 

CLIO 

SMTP: UNKNOWN USER 


Figure 249. Layout of VSE MTA Control Buffer 


24.3.3 SMTP Server 

The VSE/ESA MTA transmits the mail to the AIX SMTP server. The message 
header is scanned and control records are generated which are sent to the 
SMTP server prior to the actual mail data. 

These are the control records sent to the SMTP server: 
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Control Card Comments 

MAIL FROM: The MAIL FROM card is generated out of the "From:" 

MH-component. The "From:" MFI-component has to be the first entry 
in the message header. 

RCPT TO: For each user specified in the "To:" and "Cc:" MH-components, a 
'RCPT TO:' record is generated. 

DATA When the end-of-message indication is detected, the MTA sends a 

DATA record, indicating to the SMTP server that all following lines, up 
to the "." (dot) line, are part of the data to be sent. The MTA sends all 
message header lines after the DATA record. 

QUIT After all message lines are sent the MTA disconnects from the SMTP 
server using the SMTP 'QUIT' command. 

The VSE/ESA MTA supports a TRACE function, which writes all message lines 
and SMTP control records sent as well as the messages returned by the SMTP 
server to CIOS Temporary Storage (using a default TS Queue name of 
"lESXMAIL"). 

The following TRACE lines were written to subject TS Queue when we sent the 
sample mall message shown in Figure 247 on page 317: 
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00001 IESXMM:LDATE=00094340TI]yE=00164628 
00002 MAILCB. . . .Ml TK SXMATT, 

00003 220 aix320.itsc.ibm.com Sendmail AIX 3.2/ UCB 5.64/4.03 ready at Tu 

00004 Fromiwacker 

00005 MAIL FRCM:wacker 

00006 250 wacker... Sender is valid 

00007 To:wacker@aix320 pramot@tcpcll 

00008 RCPT TO:wacker@aix320 

00009 250 wacker@aix320... Recipient is valid 

00010 RCPT TO:pramot@tcpcll 

00011 250 pramot@tcpcll... Recipient is valid 

00012 Subject: VSE/mail 

00013 Cc:wstieber@aix320 

00014 RCPT TO:wstieber@aix320 

00015 250 wstieber@aix320... Recipient is valid 

00016 - 

00017 354 Enter mail. End with the . character on a line by itself 
00018 From:wacker 

00019 To:wacker@aix320 pramot@tcpcll 
00020 Subject: VSE/mail 
00021 Cc:wstieber@aix320 

00022 - 

00023 Hello, 

00024 this is a mail entered via the VSE message entry function. 

00025 The VSE message transfer agent generates the required SMTP 
00026 control cards and sends them to the SMTP server on AIX. 

00027 From there on the SMTP servers handle the delivery of the 
00028 mail in the TCP/IP network. 

00029 

00030 See you later on OS/2. 

00031 . 

00032 Ok 

00033 221 aix320.itsc.ibm.com: closing the connection 
00034 MAILCB. . . .MT lESXMAIL 


Figure 250. Communication between the VSE/ESA MTA Client and the SMTP Server 


24.3.4 Receiving the Maii 

To test our OC/SAM mail client we sent mail to AIX, OS/2 and Windows 
workstations. These platforms use different facilities to receive incoming mail 
from other TCP/IP nodes: 

• AIX 

The 'maii command is used to display the contents of the mailbox. From the 
mailbox prompt mailbox commands can be entered to manage the contents 
of the mailbox. 

• OS/2 

Uses the 'LaMail' Presentation Manager application. 

• Windows 

Uses the 'Mail' Windows application. 
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Using these facilities the mail systems allow you to read the incoming mail, print 
it and store it into personal mail folders. As an example Figure 251 on page 321 
and Figure 252 on page 321 show how our VSE/ESA mail was received and 
viewed using OS/2's LaMail facility. 


O LaMail 2.3 


Niitas FdIiIkis Ojttiiiit!': Iiaiisfai r\it 



Mail Fili^ Fiiit SK'tii:li 0|itii)iis ('iiiaiii.aiiM 
;;;;;;;;;;;;;;;;;;;;;;;; top of File 

Date: Tue, 13 Dec 1994 16:49:33 +0100 
From: wacker@aix320.itsc.ibm.com 

Message-Id: <9412131549.AA07560eaix320.itsc.ibm.com> 

To: wacker@aix320.itsc.ibm.com, pramot@tcpcl1.itsc.ibm.com 

Subject: VSE/mail 

Cc: wst i eber@ a i x3 2 0. i tsc. i bm. com 

Hello, I 

this is a mail entered via VSE message entry function. 

The VSE message transfer agent generates the required SMTP 
control cards and sends them to the SMTP server on AIK. 

From there on the SMTP mail servers handle the delivery of the 
mail in the TCP/IP network. 

See goo later on OS/2. 

_ 

Line 0 of 24 Column 61 1 File Insert 


Figure 252. Reading VSE/ESA SMTP Mail Using OS/2 LaMail 


24.3.5 Message Transfer Agent Program Implementation and Setup 

The MTA implementation ef the MTA is based on the sample program lESMTA 
which is available on the IBMVSE tools disk (managed by VMTOOLS at 
BOEVM3). 

The fellewing steps are required to set up lESMTA: 

• Custemize Assembler pregram lESMTA 

• Customize CICS 
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Customize OC/SAM 


No further customization is required fer VTAM, since we already previded the 
necessary APPL statements and the VTAM LU definitiens (see 24.2, “Running the 
Sampie Programs” on page 310). 


24.3.5.1 Customize lESMTA 

The foilowing adaptatiens have to be made: 

1. Define the IP address of the TCP/IP host running the SMTP server. 

2. Define the cemmunication type to be used for I/O to the OpenConnect server. 
The sample program uses SNA LUO communication by defauit. 

3. Define the LU name to be used for OCS li Gateway cemmunication. 

We used the jeb listed beiow to assembie the lESMTA program. 
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* $$ JOB JNBK;CMJrA,DISP=D,CIASS=A,NTFY=YES 

* $$ LSI DISP=D,CIASS=Q,PRI=3 

* $$ PUN DISP=I,PRI=9,CIASS=A 

// JOB COMMTA TRANSLATE PROGRAM lESMTA 

* VSE/MAIL INSTALL STEP: TRANSLATE lESMTA PROGRAM 
// LIBDEF SOURCE,SEARCH=TCPOCS.SAMMAC 

// LIBDEF OBJ,SEARCH=TCPOCS.SAMOBJ 
// ASSGN SYSIPT, SYSRDR 
// EXEC lESINSRT 
$ $$ LST DISP=D,CLASS=Q,PRI=3 
// JOB COMMTA COMPILE PROGRAM lESMTA 

* VSE/MAIL INSTALL STEP: ASSEMBLE lESMTA PROGRAM 
// LIBDEF SOURCE,SEARCH=TCPOCS.SAMMAC 

// LIBDEF OBJ,SEARCH=TCPOCS.SAMOBJ 
// SETPARM CATALOG=I 
//IF CATALOG = I THEN 
// GOTO CAT 

// OPTION ERRS, SXREF, SYM, LIST, NODECK 
// GOTO ENDCAT 
/. CAT 

// LIBDEF PHASE,CATALOG=PRD2.CONFIG 
// OPTION ERRS, SXREF, SYM, CATAL,NODECK 
PHASE lESMTA, * 

INCLUDE DFHEAI 
/. ENDCAT 

// EXEC ASMA90, SIZE= (ASMA90, 50K) ,PARiy^<:EXIT (LIBEXIT (EDECKXIT) ) 9 

* $$ END 

//ON $CANCEL OR $ABEND GOTO ENDJ2 
// OPTION NOLIST, NODUMP, DECK 
// EXEC DFHEAPI$, SIZE=5I2K 
*ASM XOPTS (CICS) 

* $$ SLI ICCF= (lESMTA) ,LIB= (0029) 

/* 

/. ENDJ2 

// EXEC lESINSRT 
/* 

//IF CATALOG NE I OR $MRC GT 4 THEN 

// GOTO NOLNK 

// EXEC LNKEDT,SIZE=256K 

/. NOLNK 

#& 

$ $$ EOJ 

* $$ END 
/& 

* $$ EOJ 


Figure 253. Assemble Message Transfer Agent Program lESMTA 


24.3.5.2 CICS Customization 

This section covers the definitions required in CICS/VSE to enabie VSE/ESA 
users to use the MTA. The CICS CEDA transaction was used to define the 
foiiowing resources to CICS/VSE: 

• Program lESMTA 

We filed this resource under group 'VSEGROUP'. 
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The screen image frem our CEDA session is shown in the figure beiow. 


CEDA DEFINE 


PRCGram 

: lESMTA 

Group 

: VSEGROUP 

Language 

: Assembler 

RELoad 

: No 

RESident 

: No 

RSI 

: 00 

Status 

: Enabled 


REMOTE ATTRIBUTES 
REMOTESystem : 
REMOTEName : 

Transid : 

Executionset : Fullapi 


CObol I Assembler | C | Pli | Rpg 

No I Yes 

No I Yes 

0-24 I Public 

Enabled | Disabled 


Fullapi I Dplsubset 


The key parameters are: 

• PROGRAM. The name of the Message Transfer Agent program. 

• GROUP. The name of the group to which this definition beiongs. 

• LANGUAGE. The programming ianguage of this program is Assembier. 


24.3.5.3 OC/SAM Customization 

lESMTA uses the 'GET SERVICE BY NAME' function to obtain the port number 
and protocoi type for communication with the SMTP server. You need to make 
sure that your 'GET SERVICE BY NAME' table contains an entry for this port. The 
default table provided by OC/SAM contains this entry, as shown in the figure 
below. 


DC 

CLCOdSMTPd 

Name of service 

DC 

Hd25d 

Port number service is using 

DC 

CL4<:TCPd 

Protocol service is using 

DC 

CL20d 

Alias name for service 


Figure 254. SMTP Entry in Defauit 'GET SERVICE BY NAME' Table 


If the table does not contain an entry for SMTP, add an entry as described in 
11.2.1, “GET SERVICE BY NAME Table Customization” on page 150. 
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Chapter 25. Implementation Summary 


The successful implementatien of OCS products with VSE/ESA depends heavily 
on your understanding of the: 

• Definition requirements in VSE/ESA and the OCS products 

• Relationships between the VSE/ESA and OCS products customization 

The definitions required in VSE/ESA and the OCS II Gateway are covered in 
previous chapters. This chapter summarizes the relationships between the 
definitions in the different subsystems affected using a number of figures. 

These figures are meant to help you to better understand the implementation of 
OCS products. Pointers in the figures illustrate the relationships of the 
definitions and where parameter values must match. 

The following definition relationships are illustrated: 

• VTAM and OCS II Gateway Definitions 

• OC/FTP Server Definitions 

• OC/FTP Client, OC/RSH Client, and OC/LPD Definitions 

- VTAM and CICS Definitions 

- VTAM, OC/FTP Client, OC/RSH Client and OCS II Gateway Definitions 

• OC/TELNET FS Definitions 


© Copyright IBM Corp. 1995, 1996 
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25.1 VTAM and OCS II Gateway Definitions 


VTAM Start Options List 


NETID=DEIBMIPF 

VTAM LAN Major Node 


TCPPORT PORT CUADDR=300 


MACADDR=400020201002 

OCS II GATEWAY 

SAPADDR=4 

MAXDATA=0 

Optons File Values: 

TCPTRGl GROUP DIAL=YES.. 

NETID DEIBMIPF 

TCPTRLl LINE CALL=INOUT 

IPFP2209 PU 

DLC Configuration: 


Remote Link Address 

VTAM Major Node for 

400020201002 

OCS II Gateway 

Remote Link SAP 4 

IPFP2209 PU ADDR=04 

RS/6000 TRA LAA: 


400010101009 

MACADDR=400010101009 

SNA Configuration: 


Data Link Buffer 2048 

MAXDATA=2057 

Station Address 4 

SAPADDR=4 

PU Type 2 

PUTYPE=2 

XID 2017E0009 

IDBLK=017 

IDNUiyt=E0009 

PU IPFP2209 

LU 1 IPFT2S9A 

IPFT2S9A LU LOCADDR=l 

LU 2 IPFT2S9B 

IPFT2S9B LU LOCADDR=2 

LU 16 IPFT2S9P 

IPFT2S9P LU LOCADDR=16 


Figure 255. OCS II Gateway and VTAM Definitions 
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25.2 OC/FTP Server Definitions 


VTAM TCPAPPL Major Node CONFIG. TCP IP 

OCSFTPS APPL ACBNAME OCSFTPS 

iyDDTAB=OCSBIND 
DLOGiyDD=OCSLUO 


VTAM OCSBIND MODETAB 
OCSLU62P MGDEENT 
OCSLUO MGDEENT 
OCSMD2 MGDEENT 


VTAM Major Node for 
CCS II Gateway 

IPFP2209 PU 

IPFT2S9A LU 

iyDDETAB=OCSBIND 

DLOGiyDDE=OCSLUO 

LOGAPPIKX:SFTPS 

IPFT2S9B LU 
IPFT2S9C LU 


IPFT2S9P LU 


Figure 256. OC/FTP Server Definitions Summary 
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25.3 OC/FTP Client, OC/RSH Client and OC/LPD Definitions 

25.3.1 VTAM and CICS Definitions 


VTAM TCPAPPL Major Node 

CEDA CONNECTION VSE 

OCSFTP62 APPL 

M3DTAB=0CSBIND 

DLOGM3D=OCSLU62P 

NETNAME OCSFTP62 

OCSFTPOl APPL 

M3DTAB=OCSBIND 

DLOGM3D=OCSLUO 

OCSFTP02 APPL 

M3DTAB=OCSBIND 

DLOGM3D=OCSLUO 


OCSFTPIO APPL 

CEDA SESSION VSESESS 

VTAM OCSBIND MDDETAB 

CONNECTION VSE 

OCSLU62P M3DEENT 

MODENAME OCSLU62P 

OCSLUO M3DEENT 


OCSMD2 M3DEENT 

CEDA TRANSACTION FTP 

CEDA TRANSACTION RSH 

VTAM Major Node for 

CCS II Gateway 

PROGRAM APPCFTPC 

IPFP2209 PU 

IPFT2S9A LU 

IPFT2S9B LU 

M3DETAB=OCSBIND 

DLOGMDDE=OCSLUO 

IPFT2S9C LU 

CEDA PROGRAM APPCFTPC 

GROUP VSEGROUP 

IPFT2S9I LU 


IPFT2S9J LU 


IPFT2S9P LU 



Figure 257. OC/FTP Client and OC/RSFi Client Definitions Summary - VTAM and CICS 
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25.3.2 VTAM, OC/FTP Client and OCS II Gateway Definitions 


VTAM TCPAPPL Major Node 


OCSFTP62 APPL 

FAPPL.FTP 

OCSFTPOl APPL 

OCSFTPOl 

OCSFTP02 APPL 

OCSFTP02 

OCSFTPIO APPL 

OCSFTPIO 


NETWORKS.FTP 

VTAM Major Node for 

SUNNET 192.61.200 

OCS II Gateway 

IPFNET 192.61.100 

AIXNET 9.164.182 

IPFP2209 PU 


IPFT2S9A LU 

IPFNET.FTP 

IPFT2S9B LU 

LU IPFT2S9B 

IPFT2S9C LU 

LU IPFT2S9C 

IPFT2S9D LU 

LU IPFT2S9D 

IPFT2S9E LU 

LU IPFT2S9E 

IPFT2S9F LU 

IPFT2S9G LU 

AIXNET.FTP 

IPFT2S9H LU 

LU IPFT2S9F 

IPFT2S9I LU (LPD) 

LU IPFT2S9G 

IPFT2S9J LU 

SUNNET.FTP 

IPFT2S9P LU 

LU IPFT2S9H 

HOSTS.FTP 

PACING.FTP 

192.61.100.84 TCPCL2 

10.10 TCPCL2 

CACHE.FTP 

OCS II GATEWAY CONFIG 

192.61.100.84 TCPCL2 

IP Addr: 192.61.100.81 

RESOLVER.FTP 

Indirect Route: 

192.61.100.55 

SERVER 192.61.100.83 

Default Route: 

DOMAIN ITSC. IBM. COM 

192.61.100.83 


NETMASK.FTP 

AIX320 TCPCLl TCPCL3 

9.164.182 255.255.255.0 


Figure 258. OC/FTP Client Definitions Summary - VTAM, FTP Client and OCS tl Gateway 
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25.4 OC/TELNET FS Definitions 


VTAM TCPAPPL Major Node 

SYSIN File 

VSTELNET APPL 

iyDDTAB=OCSBIND 

DLOGiyDD=OCSLUO 

NETNAME VSTELNET 

VSNETOOl APPL 

M3DTAB=OCSBIND 

DLOGMDIXXSLUO 

VSNET002 APPL 

iyDDTAB=OCSBIND 

DLOGiyDD=(XSLUO 

HOSTS File 

192.100.61.81 AIX320 

192.61.100.82 TCPGTW2 

192.61.100.83 TCPCLl 

192.61.100.84 TCPCL2 

VSNET064 APPL 


VTAM OCSBIND MDDETAB 

OCS II GATEWAY CONFIG 

OCSLU62P MODEENT 

OCSMD2 MDDEENT 

OCSLUO MDDEENT 

IP addr: 192.61.100.81 

Indirect Route: 

192.61.100.55 

Default Route: 

192.61.100.83 

VTAM Major Node for 

CCS II Gateway 


IPFP2209 PU 

NETWORKS File 

IPFT2S9A LU 

IPFT2S9B LU 

IPFNET 192.61.100 

IPFT2S9I LU 

IPFNET File 

IPFT2S9J LU 

MDDETAB=OCSBIND 

DLOGMDDE=(XSLUO 

IPFT2S9K LU 

MDDETAB=OCSBIND 

DLOGMDDE=OCSLUO 

LU IPFT2S9J 

LU IPFT2S9K 

LU IPFT2S9L 

IPFT2S9P LU 



Figure 259. OC/TELNET FS Definitions Summary 
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25.5 Issues and Concerns 


The following list summarizes the issues and concerns found during our 
implementation of the OCS II Gateway and its products as described in the 
previous chapters. The comments are based on the software levels and 
documentation available to us and described in 4.2, “Software” on page 32 and 
the list of OpenConnect Systems publications in the Bibliography. 

• Security aspects of OC/FTP Server. Once an FTP client has been able to log 
in to OC/FTP Server, he can change access modes and working directories 
within VSE without having to pass any further access barriers (refer to 6.2.3, 
“FTP Server Customization” on page 67). 

• A problem determination manual for all components of OCS TCP/IP for VSE 
is not available; this makes it difficult to perform any kind of more detailed 
analysis if problems arise. 

• In general, the quality of the documentation, particularly with respect to 
topics related to VSE/ESA, can be improved by showing the relationships 
between the different systems and subsystems involved. 
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Part 3. Summary 


The purpose of this part is to summarize the functiens and iimitations of the 
OpenConnect Systems preducts. 

- Note - 

The conciusions drawn in this part are based on the foiiowing ieveis of 
subject products: 

• OCC Software V1.3 

• OC/FTP Server V2.2.4.1 

• OC/FTP Ciient V2.2.4.1 

• OC/LPDV1.1.0 

• OC/RSH Ciient V2.1.5 

• OC/TELNET FS V4.11 

• OC/SAM V2.1 

• OCS li Gateway V3.7.5 

• OC/Print Server for AIX V1.2 

Future enhancements and/or modifications of the prcducts may make this 
part or portions of it obsoiete. Piease check with the iatest announcement 
ietters and preduct manuais before making your purchase decisicn. 


The OpenCcnnect Systems product provides gateway functions to aiiow VSE/ESA 
users to participate in TCP/iP netwerks. 

This part provides a quick summary of the products' functions and iimitations. 

We aiso discuss a few user requirements te iilustrate how the prcduct addresses 
these situations. We hcpe that this expianaticn wiil heip you to: 

• Better understand the appiication aspects of the products 

• Make a better seiection of specific products based on your requirements 

The fciiowing topics are covered: 

• OpenConnect Systems Prcducts Functions and Limitations Summary 

• Seiected User Requirements 

• Conciusion 
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Chapter 26. OpenConnect Systems Products Functions and 
Limitations Summary 


The following products are currently available within the IBM Cooperative 
Software Program (CSP) from OpenConnect Systems: 

• OC/FTP Server 

• OC/FTP Client 

• OC/LPD 

• OC/RSH Client 

• OC/TELNET FS 

• OC/SAM 

• OCS II Gateway 

• OCS II Telnet Server 

• OCS Print Server for AIX 

OCS II Gateway function is already explained in 3.1, “OCS II Gateway Functional 
Overview” on page 16. We will concentrate on the FTP, RSFI and TELNET 
functions of the OpenConnect Systems products. 


26.1 OpenConnect Systems Products Functions Summary 


26.1.1 File Transfer Functions 

OC/FTP Server allows TCP/IP FTP clients to initiate and perform FTP functions 
between VSE/ESA and TCP/IP nodes, accessing the following VSE/ESA files: 

• VSAM ESDS and KSDS 

• VSE Libraries 

• POWER RDR, LST, and PUN queues 

OC/FTP Server also allows TCP/IP FTP clients to issue POWER commands to 
manipulate POWER spool files. 

OC/FTP Client allows VSE/ESA users to initiate and perform file transfer 
operations between VSE/ESA and TCP/IP nodes, accessing the TCP/IP FTP 
server's file systems and VSAM files and VSE Libraries. 


26.1.2 Remote Command Execution 

OC/RSFI Client allows you to pass commands from the VSE/ESA system to a 
remote TCP/IP host for execution. 


© Copyright IBM Corp. 1995, 1996 


335 




26.1.3 Socket API 

The OC/SAM provides a TCP/IP socket application program interface on 
VSE/ESA systems which enables the development of client/server applications in 
heterogeneous environments. In addition to the OC/SAM function library, the 
BSD 4.3 function library is available for C and ASM/370 programming. 


26.1.4 Line Printer Daemon Functions 

OC/LPD allows the LPR clients in the TCP/IP network to initiate and send print 
data to VSE/ESA. If requested, a response mail message is sent back through 
the gateway to the user via a standard SMTP well-known port. Together with 
OCS Print Server for AIX, a bidirectional printer solution is available. 


26.1.5 TELNET Functions 

OC/TELNET FS allows VSE/ESA users to initiate and establish terminal emulation 
sessions with TCP/IP TELNET servers. 

OCS II Telnet Server allows TCP/IP TELNET clients to initiate and establish 3278 
terminal emulation sessions with VSE/ESA. 


26.2 Additionai OpenConnect Systems Products Summary 


26.2.1 OpenConnection for Channei Usage 

OCC provides a direct channel attachment to the gateway. The installation of a 
small Token-Ring network between the mainframe attached 3174 controller and 
the RS/6000 gateway is avoided. 


26.2.2 OCS Print Server for AIX 

The OCS PRINT Server is an AIX process to emulate multiple 3287 CICS terminal 
printers simultaneously. The print output is automatically converted from 
EBCDIC to ASCII and routed to any local or remote printer defined on the AIX 
system. 


26.2.3 OC://WebConnect Overview 

OC://WebConnect provides users access to real-time mainframe application data 
from their desktops using any Java-capable Web browser. 

Please check with OpenConnect Systems for additional information. 
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26.3 OpenConnect Systems Products Limitations 

The OpenConnect Systems preducts that we tested have the following 
limitations: 

• No programming capability In command files 

There Is no logic statement available for the OC/FTP Client and OC/TELNET 
FS command files. Without the programming capability, file transfer or 
TELNET logon that require conditional decisions must be handled manually 
by the users. 

Please check with OpenConnect Systems fer additional Information. 
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Part 4. Job Streams and Definition Examples 
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Appendix A. Job Streams and Definition Exampies for OCS Products 


A.1 Product Installation Job Streams 

* $$ JOB JNiy^INSTN,DISP=D,PRI=3, C 

* $$ NTFY=YES, C 

* $$ LDEST=*, C 

* $$ CLASS=0 

// JOB SCAN SCAN OPTIONAL PRODUCT TAPE 
// LIBDEF PHASE, SEARCH={PRD1.BASE, IJSYSRS.SYSLIB) 

■k k 

* * - SCAN PROGRAM TAPE 

■k k 

// ASSGN SYS006,180 

// EXEC DTRIPRE,PAR]y^<:ADDR=180<: 

/* 

/& 

* $$ EOJ 


* $$ JOB JNiyKX:SINST,CLASS=0,DISP=D,NTFY=YES 
// JOB OCSINST INSTALL OCS PRODUCT 

// ASSGN SYS006,180 
// MIC REW,SYS006 
// EXEC MSHP 

INSTALL PRODUCT FRCMTAPE - 
PRODUCTION INTO=lib.sublib 

/* 

// MIC RUN,SYS006 
/& 

* $$ EOJ 


A.2 VSE VTAM Start Options List 

* $$ JOB JN]yNCATSTRl,DISP=D,PRI=3,NTFY=YES,LDEST=*,CLASS=0 


// JOB CATSTRl CATALOG VTAM START OPTION LIST 
// EXEC LIBR, PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 

CATALOG ATCSTROl.B REPLACE=YES 

SSCPID=22, C 

HOSTSA=22, C 

SSCPNAME=IPFV2B, C 

HOSTPU=IPFVM22, C 

NETID=DEIBMIPF, C 

MAXSUBA=255, C 

CONFIG=01, C 

IOINT=0, C 

SGALIMIT=0, C 

BSBUF=(28, ,,1), C 

CRPLBUF=(60,,,1), C 

LFBUF=(200,288,,20), FROM 70 TO 200 C 

LPBUF=(12, ,,6), C 

SFBUF=(20, ,,20), C 
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SPBUF=(210,,,32), C 

VFBUF=204800, FROM 102400 TO 204800 C 

VPBUF=528384, FROM 446464 TO 528384 C 

XDBUF={6, ,,1) 

/+ 

/* 

/& 

* $$ EOJ 


A.3 VSE TCPSW.B Switched Major Node 

* $$ JOB JNiy^TCPSW,DISP=D,PRI=3,NTFY=YES,LDEST=(,RSCS) ,CLASS=0 

* $$ LST CLASS=A 
// JOB TCPSW 

// EXEC LIBR, PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 
CATAIJOG TCPSW.B REPIACE=YES 

■k 

* IAN RELATED SWITCHED MAJOR NODE FOR RS/6000 GATEWAY AND PS/2 

■k 

TCPSW VBUILD TYPE=SWNET 


* PU AND LU DEFINITION FOR RS/6000 OCS GATEWAY 

■k 

IPFP2209 PU ADDR=04,MACADDR=400010101009, lAA FOR RS/6000 C 

IANSW=YES, LAN capable C 

IDBLK=017, ID BLOCK REQUIRED BY OCS C 

IDNUNbEOOOg, IDNUM SET BY ITSC CONVENTION C 

DISCNT=NO, VTAM DOES NOT HANG UP C 

PACING=0,VPACING=0, NO PACING AS DEFAULT C 

PUTYPE=2, PU TYPE REQUIRED BY OCS C 

MAXDATA=2057, SET TO 2057 FOR 2K PIU C 

ISTATUS=ACTIVE, C 

LANACK= (01.0,1), LAN ACKNOWLEDGEMENT VALUES C 

LANINACT=02.0, timer for inactive link station C 

LANCON= (05.0,1), LAN TIMER AND RETRY COUNT C 

LANSDWDV^(2,1), send window & window step C 

LANRESP=(02.0,2), Timer for connected state C 


SAPADDR=4 service access point address 

k 

* LU DEFINITION FOR RS/6000 GATEWAY 

k 

* IPFT2S9A FOR OC/FTP SERVER 

* IPFT2S9B, C, D, E, F, G, H, I FOR OC/FTP CLIENT 

* IPFT2S9J, K, L FOR OC/TELNET CLIENT OUTBOUND SESSIONS 

* IPFT2S9M FOR TERMINAL PRINTER 

* IPFT2S9N,0 FOR OC/TELNET SERVER INBOUND SESSIONS 


IPFT2S9A LU LOCADDR=1,DLOGMOD=OCSLUO,LOGAPPL<X:SFTPS, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

MDLTAB=VTMMDL,MDLENT=VSELU2A, C 

SSCPFiybUSSSCS, USSTAB=VTMUSSTR 

IPFT2S9B LU LOCADDR=2,DLOGMOD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

MDLTAB=VTMMDL,MDLENT=VSELU2A, C 

SSCPFiybUSSSCS, USSTAB=VTMUSSTR 
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IPFT2S9C LU LOCADDR=3,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

P«LTAB=V]>M)L,P«I£Nr=^^ C 

SSCPEiy^USSSCS, USSTAB=VrMUSSTR 

IPFT2S9D LU LOCADDR=4,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MDDETAB=OCSBIND, C 

P»LTAB=V]>M)L,P»I£Nr=VSE^^ C 

SSCPFiy^USSSCS, USSTAB=VrMUSSTR 

IPFT2S9E LU LOCADDR=5,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

P«LTAB=V]>M)L,P«LENr=VSELU2A, C 

SSCPELL=USSSCS, USSTAB=VrMUSSTR 

IPFT2S9F LU LOCADDR=6,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

PCLTAB=V]>M)L,P»LENr=VSELU2A, C 

SSCPELL=USSSCS, USSTAB=VrMUSSTR 

IPFT2S9G LU LOCADDR=7,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

P«LTAB=V]>M)L,P«LENr=VSELU2A, C 

SSCPELL=USSSCS, USSTAB=VrMUSSTR 

IPFT2S9H LU LOCADDR=8,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MDDETAB=OCSBIND, C 

P»LTAB=V]>M)L,P»LENT=VSELU2A, C 

SSCPFLL=USSSCS, USSTAB=VrMUSSTR 

IPFT2S9I LU LOCADDR=9,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

P«LTAB=V]>M)L,P«LENr=VSELU2A, C 

SSCPELL=USSSCS, USSTAB=VrMUSSTR 

■k 

IPFT2S9J LU LOCADDR=10,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

P»LTAB=V]>M)L,P»LENr=VSELU2A, C 

PACING=1,VPACING=2, C 

SSCPFiy^USSSCS, USSTAB=VrMUSSTR 

IPFT2S9K LU LOCADDR=ll,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

P»LTAB=V]LM)L,P»LENr=VSELU2A, C 

PACING=1,VPACING=2, C 

SSCPFiy^USSSCS, USSTAB=VrMUSSTR 

IPFT2S9L LU LOCADDR=12,DLOGiyDD=OCSLUO, C 

ISTATUS=ACTIVE,MDDETAB=OCSBIND, C 

P«LTAB=V]>M)L,P»LENr=VSELU2A, C 

PACING=1,VPACING=2, C 

SSCPELL=USSSCS, USSTAB=VrMUSSTR 

IPFT2S9M LU L0CADDR=13, DLOGiyDD=OCSDSC, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

PCLTAB=V]>M)L,P»LENr=VSELU2A, C 

PACING=1,VPACING=2, C 

SSCPELL=USSSCS, USSTAB=VrMUSSTR 

IPFT2S9N LU LOCADDR=14,DLOGiyDD=OCSMD2, C 

ISTATUS=ACTIVE,MODETAB=OCSBIND, C 

P»LTAB=V]>M)L,P»LENT=VSELU2A, C 

PACING=1,VPACING=2, C 

SSCPFiy^USSSCS, USSTAB=VrMUSSTR 

IPFT2S90 LU LOCADDR=15,DLOGiyDD=OCSMD2, C 

ISTATUS=ACTIVE,MDDETAB=OCSBIND, C 

P«LTAB=V]>M)L,P«LENr=VSELU2A, C 

PACING=1,VPACING=2, C 

SSCPFiy^USSSCS, USSTAB=VrMUSSTR 
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IPFT2S9P LU 


IOPADDR=16,DLOGiyDD=OCSMD2, C 
ISTATUS=ACTIVE,MODETAB=OCSBIND, C 
P»LTAB=V]>M)L,P»I£Nr=^^ C 
PACING=1,VPACING=2, C 


SSCPEiy^USSSCS, USSTAB=VrMUSSTR 

■k 

/+ 

/* 

/& 

* $$ EOJ 


A.4 VTAM APPL Major Node for OCS Products 

* $$ JOB JNiyp=TCPAPPL,DISP=D,PRI=3,NTFY=YES,LDEST=*,CIASS=0 
// JOB TCPAPPL CATALOG VTAM BOOK 

// EXEC LIBR, PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 
CATALOG TCPAPPL.B REPLACE=YES 

TCPAPPL VBUILD TYPE=APPL 
DBDCCICS APPL AUTH=(PASS,ACQ) 

CICSSA22 APPL AUTH=(PASS,ACQ,VPACE),PARSESS=YES,ACBNAMECICSSA22, C 
EAS=4000,MODETABCICSIPMT,APPC=NO, C 

SONSCIP=YES,VPACING=5 
POWER APPL AUTH=(ACQ) 

PNET APPL AUTH= (PASS, ACQ), VPACING=3, PDDETAB=VTMLOGTB, DLOGMOD=PNET 
lESWAITT APPL AUTH= (NOACQ) 

■k 

* OCS FTP SERVER APPL 

OCSFTPS APPL iyDDETAB=OCSBIND,DLOGM3r>=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 

■k 

* OCS FTP CLIENT APPL 

OCSFTP62 APPL MODETAB=OCSBIND,DLOGMOD=OCSLU62P,AUTH=(ACQ) ,APPC=YES, C 
PARSESS=YES, DSESLIM^IO, DMTNWNL^O, DMI1NIWNR=10 
OCSFTPOl APPL M3DETAB=OCSBIND, DLOGM3D=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
OCSFTP02 APPL M3DETAB=OCSBIND, DLOGM3D=OCSLUO, AUTH= (NVPACE, ACQ), EAS=2 
OCSFTP03 APPL M3DETAB=OCSBIND,DLOGM3D=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 
OCSFTP04 APPL M3DETAB=OCSBIND,DLOGM3D=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 
OCSFTP05 APPL MODETAB=OCSBIND,DLOGMOD=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 
OCSFTP06 APPL MODETAB=OCSBIND,DLOGMOD=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 
OCSFTP07 APPL MODETAB=OCSBIND,DLOGMOD=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 
OCSFTP08 APPL MODETAB=OCSBIND,DLOGMOD=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 
OCSFTP09 APPL M3DETAB=OCSBIND,DLOGM3D=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 
OCSFTPIO APPL M3DETAB=OCSBIND,DLOGM3D=OCSLUO,AUTH=(NVPACE,ACQ),EAS=2 

■k 

* OCS TELNET FS APPL (64 SESSIONS) 

VSTELNET APPL AUTH= (ACQ, PASS), ACBNAME=VSTELNET 
VSNETOOl APPL AUTH=(ACQ),EAS=2,ACBNAME=VSNET001 
VSNET002 APPL AUTH=(ACQ),EAS=2,ACBNAME=VSNET002 


VSNET063 APPL AUTH= (ACQ),EAS=2,ACBNAME=VSNET063 
VSNET064 APPL AUTH= (ACQ),EAS=2,ACBNAME=VSNET064 

■k 

* ACB FOR SOCK$AM. THESE ACBOS ARE USED BY BOTH TCP AND UDP. 

UDPTESTl APPL ACBNAME=UDPTEST1, APPLID FOR ACB C 

AUTH=(ACQ), AUTHORIZED FOR ACQUIRING LUS C 

EAS=2 ESTIMATED CONCURRENT SESSIONS 


344 TCP/IP for VSE/ESA 




UDPTEST2 APPL ACBNAME=UDPTEST2, 
AUTH= (ACQ), 

EAS=2 


APPLID FOR ACB C 
AUTHORIZED FOR ACQUIRING LUS C 
ESTIMATED CONCURRENT SESSIONS 


TCPTESTI APPL ACBNAME=TCPTESTI, 
AUTH= (ACQ), 

EAS=2 

TCPTEST2 APPL ACBNAME=TCPTEST2, 
AUTH= (ACQ), 

EAS=2 


APPLID FOR ACB C 

AUTHORI ZED FOR ACQUIRING LUS C 
ESTIMATED CONCURRENT SESSIONS 
APPLID FOR ACB C 

AUTHORI ZED FOR ACQUIRING LUS C 
ESTIMATED CONCURRENT SESSIONS 


* THIS ACB IS USED BY THE SAMPLE 
VTAMOPR APPL ACBNAME=VTAMOPR, 
AUTH= (SPO), 

EAS=2 


LIBRARY MEMBER OVTAMOPERO 
APPLID FOR ACB 
AUTHORI ZED FOR ACQUIRING LUS 
ESTIMATED CONCURRENT SESSIONS 


C 

C 


/+ 

/* 

/& 

* $$ EOJ 


A.5 VTAM USSTAB 


* $$ JOB JNiy^USSTAB,CLASS=0,DISP=D 

// JOB USSTAB CREATE USS TABLE FOR OCS AND XDOMAIN 



* * JOBSTEP 1 * 

■k -k -k 


IF THERE IS NO APPLICATION NAME CORRESPONDING TO A * 
PARTICULAR VARIABLE, DELETE THE USSPARM STATEMENT * 
CONTAINING THE VARIABLE; ALSO, DELETE THE USSCMD STATEMENT * 
PRECEEDING IT AND THE USSPARM STATEMENT FOLLOWING IT. * 


// EXEC LIBR, PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 

CATALOG VTMUSSCD.A REPLACE=YES 

■k 

A USSCMD CMD=A,REP=LOGON,FORMAT=BAL 

USSPARM PARM=P1, RFP=APP T JD , DEFAUT ,T=DRDCCTCS 
USSPARM PARiyp=P2,REP=DATA 

■k 

B USSCMD CMD=B,REP=LOGON,FORMAT=BAL 

USSPARM PARM=P1, RFP=APP T JD , DEFAUT ,T=CTCSSA22 
USSPARM PARiyp=P2,REP=DATA 

■k 

C USSCMD CMDC,REP=LOGON,FORMAT=BAL 

USSPARM PARM=P1 ,RFP=APP TJD , DEFAULT=IPFA2GL3 
USSPARM PARiyp=P2,REP=DATA 

■k 

D USSCMD CMD=D,REP=LOGON,FORMAT=BAL 

USSPARM PARM=P1 ,REP=APP TJD , DEFAULT=VSTELNET 
USSPARM PARiyp=P2,REP=DATA 

■k 

E USSCMD CMD=E,REP=LOGON,FORMAT=BAL 

USSPARM PARM=P1, RFP=APP T JD , DEFAUT ,T=TPFA2VSC 
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USSPARM PARiy^P2,REP=DATA 


F USSCMD CMD=F,REP=LOGON,FORMAT=BAL 

USSPARM PARiy^Pl,REP=APPLID,DEFAULTCICSSA22 
USSPARM PARiy^P2,REP=DATA 

■k 

/+ 

/* 


* * JOBSTEP 2 * 

■k -k -k 

* * IF THERE IS NO APPLICATION NAME CORRESPONDING TO A * 

* * PARTICULAR VARIABLE, REPLACE IT WITH_TO INDICATE * 

* * THAT THERE IS NO NAME. * 


// EXEC LIBR, PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 
CATALOG VTMUSSTZ.A REPLACE=YES 

■k 

* THE FOLLOWING MENU WILL BE DISPLAYED ON SNA TERMINALS ONLY 

★ 

★ 


DC 

XOISO 

NEW LINE 

(ROW 5) 

DC 

CL9<: 0 



DC 

CL2<:A <: 



DC 

CLSODBDCCICSO 



DC 

X<:15<: 

NEW LINE 

(ROW 6) 

DC 

CL9<: 9 



DC 

CL29B 9 



DC 

CL89CICSSA229 



DC 

X9I59 

NEW LINE 

(ROW 7) 

DC 

CL99 9 



DC 

CL29C 9 



DC 

CL89VMESASA29 



DC 

X9I59 

NEW LINE 

(ROW 8) 

DC 

CL99 9 



DC 

CL29D 9 



DC 

CL89VSTELENT9 



DC 

X9I59 

NEW LINE 

(ROW 9) 

DC 

CL99 9 



DC 

CL29E 9 



DC 

CL89VM/ESAI29 



DC 

X9I59 

NEW LINE 

(ROW 10) 

DC 

CL99 9 



DC 

CL29F 9 



DC 

CL89 9 




■k 


/+ 

/* 



* * JOBSTEP 3 
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■k -k 


IF THERE IS NO APPLICATION NAME CORRESPONDING TO A * 

PARTICULAR VARIABLE, REPLACE IT WITH_TO INDICATE * 

THAT THERE IS NO NAME. * 


// EXEC LIBR, PARM=<:MSHP<: 

ACCESS SUBLIB=PRD2.CONFIG 
CATALOG VTMUSSTX.A REPLACE=YES 

■k 

* THE FOLLOWING MENU WILL BE DISPLAYED ON NON-SNA TERMINALS ONLY 


DC 

X<:II<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:C5C9<: 

ROW 5 COLUMN 10 

DC 

XOIDO 

START FIELD ORDER 

DC 

XOFSO 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

CL2<:A <: 


DC 

XOIDO 

START FIELD 

DC 

XOFOO 

PROTECT SKIP NORMAL 

DC 

CLSODBDCCICSO 


DC 

X<:II<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:C6D9<: 

ROW 6 COLUMN 10 

DC 

XOIDO 

START FIELD ORDER 

DC 

XOFSO 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

CL2<:B <: 


DC 

XOIDO 

START FIELD 

DC 

XOFOO 

PROTECT SKIP NORMAL 

DC 

CL8<:CICSSA22<: 


DC 

X<:II<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:C7E9<: 

ROW 7 COLUMN 10 

DC 

XOIDO 

START FIELD ORDER 

DC 

XOFSO 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

CL2<:C <: 


DC 

XOIDO 

START FIELD 

DC 

XOFOO 

PROTECT SKIP NORMAL 

DC 

CL8<:VMESASA2<: 


DC 

X<:II<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:C8F9<: 

ROW 8 COLUMN 10 

DC 

XOIDO 

START FIELD ORDER 

DC 

X<:F8<: 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

CL2<:D <: 


DC 

XOIDO 

START FIELD 

DC 

XOFOO 

PROTECT SKIP NORMAL 

DC 

CL8<:VSTELNET<: 


DC 

X<:II<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:4AC9<: 

ROW 9 COLUMN 10 

DC 

XOIDO 

START FIELD ORDER 

DC 

X<:F8<: 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

CL2<:E <: 


DC 

XOIDO 

START FIELD 

DC 

XOFOO 

PROTECT SKIP NORMAL 

DC 

CL8<:VM/ESAI2<: 


DC 

X<:II<: 

SET BUFFER ADDRESS ORDER 
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DC 

X<:4BD99 

ROW 10 COLUMN 10 

DC 

XOIDO 

START FIELD ORDER 

DC 

X<:F8<: 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

CL2<:F 9 


DC 

X91D9 

START FIELD 

DC 

X9F09 

PROTECT SKIP NORMAL 

DC 

CL89 9 



:*r 

/+ 

/* 

// LIBDEF *,SEARCH=(PRD1.BASE,PRD2.CONFIG),TEMP 
// LIBDEF PHASE,CATALOG=PRD2.CONFIG 
// OPIION CATAL 
PHASE VHMUSSTR, * 

// EXEC ASSEMBLY 

PRINT NOGEN 

VTMUSSTR USSTAB TABLE=STDTRANS, FORMAT=DYNAMIC 

■k 

COPY VMJSSCD 

:*r 

TEST USSCMD CMD=IEST, REP=IEMrEST, FORMAT=BAL 
USSPARM PARiyp=Pl,DEFAULT=10 
USSPARM PARiyp=P2, DEFAULT=OK 

MESSAGES USSMSG MSG=0, IEXT=<:CCMyAND ACCEPTED^ 

USSMSG MSG=1, BUFFER=MI1 
USSMSG MSG=2, BUFFER=MI1 

USSMSG MSG=3, IEXT=<:ERROR IN VIMUSSTR. PRESS ENTERS 

USSMSG MSG=4,IEXT=<:APPLICATION NOT ACTIVATED. PRESS ENTERS 

USSMSG MSG=5,BUFFER=MI1 

USSMSG MSG=6, IEXT=<:LOGON ALREADY PENDING^ 

USSMSG MSG=7,IEXT=<:%(1) UNABLE TO ESTABLISH SESSION - %(2) F* 
AILED WITH SENSE % (3)<: 

USSMSG MSG=8,IEXT=<:INSUFFICIENT STORAGES 
USSMSG MSG=9, IEXT=<:MAGNETIC CARD DATA ERRORS 
USSMSG MSG=10,BUFFER=MI1 

USSMSG MSG=12,TEXT=<:REQUIRED PARAMETER CMITTEDO 
USSMSG MSG=13,TEXT=<:IHyECHO%<: 

■k 

STDTRANS DC 128AL1(*-STDTRANS) 

DC X<:80C1C2C3C4C5C6C7C8C98A8B8C8D8E8F<: 

DC X<: 90D1D2D3D4D5D6D7D8D99A9B9C9D9E9F<: 

DC XCAn A1E2E 3E4E5E6E7E8E9AAARACADAEAFC 

DC X<:B0B1B2B3B4B5B6B7B8B9BABBBCBDBEBF<: 

DC X<:C0C1C2C3C4C5C6C7C8C9CACBCCCDCECF<: 

DC X<:D0D1D2D3D4D5D6D7D8D9DADBDCDDDEDF<: 

DC X<:E0E1E2E3E4E5E6E7E8E9EAEBECEDEEEF<: 

DC X<:F0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF<: 

END USSEND 

k 

Ml DC AL2 (MIE-MIS) 

MIS DC XOISC NEW LINE (ROW 1) 

k 

* VIMUSSTR VTAM APPLICATION SELECTION MENU 

k 

DC CLIO C 
DC a,8CVSEE SA 22C 
DC CL12<: 0 

DC COVTAM APPLICATION SELECTION MENU9 
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* ENTER THE CHARACTER OF YOUR SELECTION AND PRESS THE ENTER KEY: 

* (MIXED-CASE) 


DC 

XOISC 

NEW LINE (ROW 2) 

DC 

XOISC 

NEW LINE (ROW 3) 

DC 

CL39 C 


DC 

X<:C595A3859940A388854083888I998I83A38599409686409 

DC 

X<:A896A49940A285938583A3899695408I958440979985A2A240<: 

DC 

X<:A3888540C5D5E3C5D9409285A87A<: 

DC 

XOISC 

NEW LINE (ROW 4) 

COPY 

VTMUSSTZ 


DC 

9X9159 

SKIP 9 LINES (ROW 19) 

DC 

C9 ==> 9 


EQU 

k 


END 




// EXEC LNKEDT 
// OPTION CATAL 
PHASE VTMUSSTB, * 

// EXEC ASSEMBLY 

PRINT NOGEN 

VTMUSSTB USSTAB TABLE=STDTRANS, FORMAT=DYNAMIC 

■k 

COPY VTMUSSCD 


TEST USSCMD CMD=TEST, REP=IHyiTEST, FORMAT=BAL 
USSPARM PARIL=P1,DEFAULT=10 
USSPARM PARIL=P2, DEFAULT=OK 

■k 

MESSAGES USSMSG MSG=0, TEXT=<:CGMyiAND ACCEPTED^ 

USSMSG MSG=I, BUFFER=4TL 
USSMSG MSG=2, BUFFER=4TL 

USSMSG MSG=3,TEXT=<:ERROR IN VTMUSSTB. PRESS ENTERS 

USSMSG MSG=4,TEXT=<:APPLICATION NOT ACTIVATED. PRESS ENTERS 

USSMSG MSG=5,BUFFER=4TL 

USSMSG MSG=6, TEXT=<:LOGON ALREADY PENDING^ 

USSMSG MSG=7,TEXT=<:%{1) UNABLE TO ESTABLISH SESSION - %(2) F* 
AILED WITH SENSE %(3)2 
USSMSG MSG=8,TEXT=<:INSUFFICIENT STORAGES 
USSMSG MSG=9, TEXT=<:MAGNETIC CARD DATA ERRORS 
USSMSG MSG=I0,BUFFER=4TL 

USSMSG MSG=I2,TEXT=<:REQUIRED PARAMETER CMITTEDO 
USSMSG MSG=I3,TEXT=<:IHyECHO%<: 


STDTRANS DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 

END USSEND 


I28ALI(*-STDTRANS) 

X<:80CIC2C3C4C5C6C7C8C98A8B8C8D8E8F<: 

X<:90DID2D3D4D5D6D7D8D99A9B9C9D9E9F<: 

X<:A0AIE2E3E4E5E6E7E8E9AAABACADAEAF<: 

X<:B0BIB2B3B4B5B6B7B8B9BABBBCBDBEBF<: 

X<:C0CIC2C3C4C5C6C7C8C9CACBCCCDCECF<: 

X<:D0DID2D3D4D5D6D7D8D9DADBDCDDDEDF<: 

X<:E0EIE2E3E4E5E6E7E8E9EAEBECEDEEEF<: 

X<:F0FIF2F3F4F5F6F7F8F9FAFBFCFDFEFF<: 
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Ml DC 

AL2(MIE-MIS) 


MIS DC 

XOFSO 

ERASE WRITE COMMAND 

DC 

"k 

X<:C7<: 

WCC ALARM 

* VTMUSSTB 

k 

VTAM APPLICATION SELECTION MENU 

DC 

X<:11<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:40C1<: 

ROW 1 COLUMN 2 

DC 

XOIDO 

START FIELD 

DC 

XOFOO 

PROTECT SKIP NORMAL 

DC 

a,8CVSEESA22C 


DC 

X<:11<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:40D7<: 

ROW 1 COLUMN 24 

DC 

XOIDO 

START FIELD ORDER 

DC 

X<:F84 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

k 

COVTAM APPLICATION SELECTION MENUO 

* ENTER THE CHARACTER OF YOUR SELECTION AND PRESS THE ENTER KEY: 

* (MIXED-CASE) 

k 

DC 

X<:11<: 

SET BUFFER ADDRESS ORDER 

DC 

X<:C2E3<: 

ROW 3 COLUMN 4 

DC 

XOIDO 

START FIELD 

DC 

XOFOO 

PROTECT SKIP NORMAL 


DC X<:C595A3859940A3888540838881998183A3859940968640<: 

DC X<:A896A49940A285938583A38996954081958440979985A2A240<: 
DC X<:A3888540C5D5E3C5D9409285A87A<: 


COPY VMJSSTX 


DC 

XCIK: 

SET BUFFER ADDRESS ORDER 

DC 

X<:D661<: 

ROW 19 COLUMN 2 

DC 

XOIDO 

START FIELD 

DC 

X<:F8<: 

PROTECT SKIP INTENSIFIED ATTRIBUTE 

DC 

o 

-o- 

II 

V 

-o- 


DC 

XOIDO 

START FIELD ORDER 

DC 

X<:40<: 

UNPROTECTED NORMAL ATTRIBUTE 

DC 

X<:13<: 

INSERT CURSOR ORDER 

DC 

X<:3C<: 

REPEAT TO ADDRESS ORDER 

DC 

XODTFOO 

ROW 20 COLUMN 1 

DC 

CC C 


DC 

XOIDO 

START FIELD ORDER 

DC 

XOFOO 

PROTECT SKIP NORMAL ATTRIBUTE 

EQU 

:*r 



END 

/* 

// EXEC LNKEDT 
/& 

* $$ EOJ 
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A.6 OCSBIND MODETAB for OCS Products 

* $$ JOB JNiyKX:SBIND,CIASS=0,DISP=D,NTFY=YES 

* $$ LSI CLASS=Q, DISP=H 
// JOB OCSBIND ASSEMBLE 

// LIBDEF *,CATAL0G=PRD2.CONFIG 
// LIBDEF SOURCE,SEARCH=PRDI.BASE 
// OPTION CATAL,LIST 
// EXEC ASMA90, SIZE= (ASMA90,50K) 

PUNCH 9 CATALOG OCSBIND.OBJ REPLACE=YES9 

PUNCH 9 PHASE OCSBIND,*9 

PRINT NOGEN 
EJECT 

OCSBIND MODETAB 
EJECT 

TITLE 9FTP-CLIENT9 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 
■k -k 

* FTP CLIENT FOR OCS TCP/IP * 

■k -k 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

OCSLU62P MODEENT LOGMODE=OCSLU62P, C 

TYPE=X9009, C 

EMPROF=X9I39, C 

TSPROF=X9079, C 

PRIPROT=X9B09, C 

SECPROT=X9B09, C 

CaMPROT=X950AI9, C 

RUSIZES=X985859, C 

SSNDPAC=X9079, C 

SRCVPAC=X9079, C 

PSNDPAC=X9079, C 

PSERVIC=X90602000000000000000023009 
TITLE 9FTP-SERVER9 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 
■k -k 

* FTP SERVER FOR OCS TCP/IP * 

* TELNET FS FOR OCS TCP/IP * 

■k -k 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

OCSLUO MODEENT LOGMODE=OCSLUO, C 

TYPE=X9009, C 

EMPROF=X9069, C 

TSPROF=X9039, C 

PRIPROT=X9009, C 

SECPROT=X9009, C 

CaMPROT=X900009, C 

RUSIZES=X9F8F89, C 

PSERVIC=X90000000000000000000000009 
TITLE 9TELNET9 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 
k k 

* TELNET CLIENT FOR OCS TCP/IP * 

k k 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

OCSMD2 MODEENT LOGMODE=OCSMD2, C 
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EMPROF=X<:03<:, C 

TSPROF=X<:03<:, C 

PRIPR0T=X<:B1<:, C 

SECPROT=X<:90<:, C 

CCMPROT=X<:3080<:, C 

RUSIZES=X<:87C7<:, C 

PSERVIC=X<:028000000000000000000200<: 

TITLE ^Printer Clients 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

k k 

* PRINTER CLIENT FOR OCS TCP/IP * 

k k 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

OCSSCS MODEENT LOGMODEKTSSCS, C 

FMPROF=X<:03<:, C 

TSPROF=X<:03<:, C 

PRIPROT=X<:BI<:, C 

SECPROT=X<:90<:, C 

CCMPROT=X<:30809, C 

RnSI 7,E S=XC8587C, C 

SRCVPAC=X<:02<:, C 

PSNDPAC=X<:04<:, C 

PSERVIC=X<:0I000000EI000000000000009 

OCSDSC MODEENT LOGMODE=OCSDSC, C 

FMPROF=X<:039, C 

TSPROF=X<:039, C 

PRIPROT=X<:BI<:, C 

SECPROT=X<:909, C 

CCMPROT=X<:30809, C 

RUSIZES=X98587<:, C 

SRCVPAC=X<:02<:, C 

PSNDPAC=X<:04<:, C 

PSERVIC=X<:030000000000000000000200<: 

TITLE CSANRAPPLICATIONC 


SAM PROGRAMMIING 


MTKLU62X MODEENT LOGMODE^:4TKLU62X, 

TYPE=X<:009, 

FMPROF=X<:I39, 

TSPROF=X<:07<:, 

PRIPROT=X<:B09, 

SECPROT=X<:B09, 

CCMPROT=X<:50DI<:, 

RUSIZES=X<:89899, 

SSNDPAC=X<:07<:, 

SRCVPAC=X<:07<:, 

PSNDPAC=X<:07<:, 

PSERVIC=X<:060200000000000000002C009 

MODEEND 

END , END OF lESINCLM 

/* 

// EXEC LNKEDT 
/* 

/& 

* $$ EOJ 


C 

C 

C 

C 

C 

C 

C 

C 

C 

C 

C 
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Appendix B. Special Notices 


This document describes how VSE/ESA hosts can be integrated into 
Transmission Control Protocol/Internet Protocol (TCP/IP) networks. It is intended 
primarily for customer personnel and IBM technical professionals with 
networking responsibilities in heterogeneous environments. 

The purpose of this publication is to help with the installation and customization 
of OCS TCP/IP for VSE. 

See the PUBLICATIONS section of the IBM Programming Announcement for the 
products listed below, for more information about what publications are 
considered to be product documentation. 

• ACF/VTAM Version 4.2.0 

• OpenConnection for Channel (OCC) 

• OpenConnect/File Transfer Program Client (OC/FTPC) 

• OpenConnect/File Transfer Program Server (OC/FTPS) 

• OpenConnect/Line Printer Daemon (OC/LPD) 

• OpenConnect/Remote Shell (OC/RSFI) 

• OpenConnect/TELNET Client Full Screen (OC/TELNET Client FS) 

• OpenConnect/Socket Access Method (OC/SAM) 

• OpenConnect Server II Gateway for RISC/6000 (OCS II Gateway) 

• OpenConnect Systems Print Server for UNIX (OCS Print Server) 

• VM/ESA Release 2.1 

• VSE/ESA Version 2.1.2 

References in this publication to IBM products, programs or services do not 
imply that IBM intends to make these available in all countries in which IBM 
operates. Any reference to an IBM product, program, or service is not intended 
to state or imply that only IBM's product, program, or service may be used. Any 
functionally equivalent program that does not infringe any of IBM's intellectual 
property rights may be used instead of the IBM product, program or service. 

Information in this book was developed in conjunction with use of the equipment 
specified, and is limited in application to those specific hardware and software 
products and levels. 

IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood, NY 10594 USA. 

The information contained in this document has not been submitted to any 
formal IBM test and is distributed AS IS. The information about non-IBM 
("vendor") products in this manual has been supplied by the vendor and IBM 
assumes no responsibility for its accuracy or completeness. The use of this 
information or the implementation of any of these techniques is a customer 
responsibility and depends on the customer's ability to evaluate and integrate 
them into the customer's operational environment. While each item may have 
been reviewed by IBM for accuracy in a specific situation, there is no guarantee 
that the same or similar results will be obtained elsewhere. Customers 
attempting to adapt these techniques to their own environments do so at their 
own risk. 
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Any performance data contained in this document was determined in a 
controiied environment, and therefore, the resuits that may be obtained in other 
operating environments may vary significantiy. Users of this document shouid 
verify the appiicable data for their specific environment. 


The foliowing document contains exampies of data and reports used in daily 
business operations. To iiiustrate them as compieteiy as possibie, the exampies 
contain the names of individuais, companies, brands, and products. Aii of these 
names are fictitious and any similarity to the names and addresses used by an 
actuai business enterprise is entireiy coincidentai. 

Reference to RTF numbers that have not been reieased through the normai 
distribution process does not impiy generai avaiiabiiity. The purpose of 
including these reference numbers is to aiert IBM customers to specific 
information reiative to the impiementation of the RTF when it becomes availabie 
to each customer according to the normai IBM RTF distribution process. 


The foilowing terms are trademarks of the Internationai Business Machines 
Corporation in the United States and/or other countries: 


ACF/VTAM 

AIX 

AS/400 

CICS/VSE 

Current 

ESCON 

ILE 

MVS/XA 

Presentation Manager 
PSL 

RISC System/6000 

RS/6000 

SAA 

SP1 

System/370 

VSE/ESA 

XT 


Advanced Peer-to-Peer Networking 

APPN 

CICS 

CUA 

DB2 

IBM 

MVS/ESA 

OS/2 

PS/2 

RETAIN 

RMF 

S/370 

SKI 

SXM 

VM/ESA 

VTAM 


The following terms are trademarks of other companies: 


APOLLO 

C-bus 

DEC VT100 

DEC VT200 

DOS 

Ethernet 

HP 

Microsoft 

Network File System 
NFS 

OpenConnect 
OpenConnect Product 
Names 
PC Direct 

SunOS 

SX 

UNIX 

Windows, Windows 95 logo 


Hewlett-Packard Company 
Corollary, Inc. 

Digital Equipment Corporation 
Digital Equipment Corporation 
Microsoft Corporation 
Xerox Corporation 
Hewlett-Packard Company 
Microsoft Corporation 
Sun Microsystems, Inc. 

Sun Microsystems, Inc. 

Registered trademark of OpenConnect Systems, Inc. 
OpenConnect Systems, Inc. 

Ziff Communications Company (used by IBM Corporation 
under license) 

Sun Microsystems, Inc. 

Intel Corporation 

X/Open Company Ltd. (registered trademark in the United 
States and other countries) 

Microsoft Corporation 
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Appendix C. Related Publications 


The publications listed in this section are considered particularly suitable for a 
more detailed discussion of the topics covered in this redbook. 


C.1 International Technical Support Organization Publications 

For information on ordering these ITSO publications see “How To Get ITSO 
Redbooks” on page 359. 

• TCP/IP Solutions for VSE/ESA - Implementation Guide, GG24-4195 

• TCP/IP Tutorial and Technical Overview, GG24-3376 

• Cross Domain Networking in VM/ESA 2.0 and VSE/ESA 1.2 Environments 
Implementation Guide, GG24-4174 

• TCP/IP V.2.0 for OS/2 Installation and Interoperability, GG24-3531 

A complete list of International Technical Support Organization publications, 
known as redbooks, with a brief description of each, may be found in: 

International Technical Support Organization Bibliography of Redbooks, 
GG24-3070. 


C.2 Other Publications 

These publications are also relevant as further Information sources. 

IBM Publications 

• TCP/IP for OS/2 V2.0 Installation and Administration, SC31-6075 

• Internetworking with TCP/IP, Volume I, SC31-6144 

• Internetworking with TCP/IP, Volume II, SC31-6145 

• VSE/ESA 2.1.2 Messages and Codes, SC33-6607 

• VSE/ESA 2.1.2 System Control Statements, SC33-6613 

• VSE/VSAM User's Guide and Application Programming, SC33-6632 

• VTAM V4R2 Messages and Codes, SC31-6493 

• VTAM V4R2 Operation, SC31-6495 

• VTAM V4R2 Resource Definition Reference, SC31-6498 

• AIX System User's Guide: Communication and Networks, GC23-2523 

OpenConnect Systems Publications 

• OpenConnection for Channel, Installation, Administration, and Operations 
Guide, 350-0466-101 

• OpenConnect/FTP Client and FTP Server, VSE Installation and User Guide, 
350-0382-101 

• OpenConnect/Line Printer Daemon for MVS and VSE Installation, Operation, 
and Administration User's Guide, 350-0443-101 

• OpenConnect Systems Print Server for UNIX - User's Guide, 350-0439-101 
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• OpenConnect/Remote File Shell Client Installation and User Guide, VSE/ESA, 
350-0201-101 

• OpenConnect Systems IBM S/370 Software Gen Guide, 350-0007-101 

• OC/Socket Access Method Installation and Programming Guide, VSE/ESA, 
35101 

• OpenConnect Server II for RISC/6000 Installation and Operation Guide, 
350-0285-101.15 

• OpenConnect/TELNET Server Manager, Administration and User's Guide, 
350-0193-101 

• OpenConnect/TELNET Client Full Screen Client Full Screen Installation Guide, 
350-0146-101 

• OpenConnect/TELNET Client Full Screen Client Full Screen User and 
Administration Guide, 350-0145-101 
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How To Get ITSO Redbooks 


This section expiains how both customers and iBM empioyees can find out about iTSO redbooks, CD-ROMs, 
workshops, and residencies. A form for ordering books and CD-ROMs is aiso provided. 

This information was current at the time of pubiication, but is continuaiiy subject to change. The iatest 
information may be found at URL http://www.redbooks.ibm.com. 


How IBM Employees Can Get ITSO Redbooks 

Empioyees may request iTSO deiiverabies (redbooks, BookManager BOOKs, and CD-ROMs) and information about 
redbooks, workshops, and residencies in the foiiowing ways: 

• PUBORDER — to order hardcopies in United States 

• GOPHER link to the Internet - type GOPHER.WTSCPOK.lTSO.lBM.COM 

• Tools disks 

To get LIST3820S of redbooks, type one of the following commands: 

TOOLS SENDTO EH0NE4 TOOLS2 REDPRTNT GET SG24xxxx PACKAGE 

TOOLS SENDTO CANVM2 TOOLS REDPRTNT GET SG24XXXX PACKAGE (Canadian users only) 

To get lists of redbooks: 

TOOLS SENDTO WTSCPOK TOOLS REDBOOKS GET REDBOOKS CATALOG 
TOOLS SENDTO USDTST MKTTOOLS MKTTOOLS GET ITSOCAT TXT 
TOOLS SENDTO USDTST MKTTOOLS MKTTOOLS GET LTSTSERV PACKAGE 

To register for information on workshops, residencies, and redbooks: 

TOOLS SENDTO WTSCPOK TOOLS ZDISK GET TTSOREGT 1996 
For a list of product area specialists in the ITSO: 

TOOLS SENDTO WTSCPOK TOOLS ZDTSK GET ORGCARD PACKAGE 

• Redbooks Home Page on the World Wide Web 

http://w3.itso.ibm.com/redbooks 

• IBM Direct Publications Catalog on the World Wide Web 

http://www.elink.ibmlink.ibm.com/pbl/pbl 

IBM employees may obtain LIST3820s of redbooks from this page. 

• ITS04USA category on INEWS 

• Online — send orders to: USIB6FPL at IBMMAIL or DKIBMBSH at IBMMAIL 

• Internet Listserver 

With an Internet E-mail address, anyone can subscribe to an IBM Announcement Listserver. To initiate the 
service, send an E-mail note to announce@webster.ibmlink.ibm.com with the keyword subscribe in the body of 
the note (leave the subject line blank). A category form and detailed instructions will be sent to you. 
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How Customers Can Get ITSO Redbooks 


Customers may request ITSO deliverables (redbooks, BookManager BOOKs, and CD-ROMs) and information about 
redbooks, workshops, and residencies in the following ways: 

• Online Orders (Do not send credit card information over the Internet) — send orders to: 


In United States: 

In Canada: 

Outside North America: 

• Telephone orders 

United States (toll free) 

Canada (toll free) 

Outside North America 
(+45) 4810-1320 - Danish 
(+45) 4810-1420 - Dutch 
(+45) 4810-1540 - English 
(+45) 4810-1670 - Finnish 
(+45) 4810-1220 - French 

• Mail Orders — send orders to: 

IBM Publications 
Publications Customer Support 
P.O. Box 29570 
Raleigh, NC 27626-0570 
USA 


IBMMAIL 

usib6fpl at ibmmail 

caibmbkz at ibmmail 

bookshop at dkibmbsh at ibmmail 


Internet 

usib6fpl@ibmmail.com 

lmannix@vnet.ibm.com 

bookshop@dk.ibm.com 


1-800-879-2755 

1-800-IBM-4YOU 

(long distance charges apply) 
(+45) 4810-1020 - German 
(+45) 4810-1620 - Italian 
(+45) 4810-1270 - Norwegian 
(+45) 4810-1120 - Spanish 
(+45) 4810-1170 - Swedish 


IBM Publications 
144-4th Avenue, S.W. 
Calgary, Alberta T2P 3N5 
Canada 


IBM Direct Services 
Sortemosevej 21 
DK-3450 Allerod 
Denmark 
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